Getting Started

Welcome to the FusionDesk Companion documentation. This guide will help you understand how to use this dashboard to monitor and manage your self-hosted FusionDesk RDP instance.

1. Deployment Overview

FusionDesk Companion is a web dashboard that connects to your self-hosted FusionDesk instance running on your own infrastructure. It provides:

  • Real-time monitoring of system resources and services
  • Management of API keys for AI providers
  • Interaction with the JARVIS AI assistant through a chat interface
  • Quick access to your RDP desktop via browser or direct connection

2. Prerequisites

Before using this dashboard, you need to have:

  • A running FusionDesk instance (self-hosted)
  • Network access to your FusionDesk instance from where you're accessing this dashboard
  • (Optional) API keys for AI providers if you want enhanced AI capabilities

3. Connecting to Your Instance

This dashboard is designed to work with a self-hosted FusionDesk instance. To connect it to your instance:

  1. Deploy your FusionDesk instance following the official instructions
  2. Ensure your instance is accessible via HTTP/HTTPS
  3. This companion app acts as a client - it doesn't require special configuration on your FusionDesk instance
  4. Use the settings page to configure any API keys you want to use

Troubleshooting

Connection Issues

If you're unable to connect to your FusionDesk instance:

  • Verify your instance is running and accessible
  • Check firewall settings and port forwarding
  • Ensure you're using the correct URL or IP address
  • Try accessing your instance directly in a browser first

API Key Problems

If AI features aren't working:

  • Verify your API keys are valid and have sufficient quota
  • Check that you've saved them in the settings page
  • Ensure your FusionDesk instance has network access to the AI provider APIs
  • Check the JARVIS logs on your instance for authentication errors

Voice Features

For voice input/output to work:

  • Use Chrome, Edge, or Safari for best voice support
  • Grant microphone permissions when prompted
  • Ensure your system has audio output capabilities for voice responses
  • Some corporate networks may block WebSocket connections used for voice