VNC viewer
See and control your desktop remotely through the built-in VNC viewer.
Your desktop in the browser
The dashboard embeds a full VNC viewer. You can see the XFCE desktop, move the mouse, type on the keyboard, and watch your AI agent work, all without installing anything.
How it works
- A VNC server runs inside the VM, renders the XFCE desktop, and serves it over a WebSocket connection.
- Your browser receives the stream and displays the desktop.
All traffic goes through Le Bureau's authenticated WebSocket proxy. No direct VM access is needed.
Connecting
- Open your desktop from the dashboard.
- The VNC viewer loads automatically in the main panel.
- Once the desktop is
running, you see the XFCE desktop.
If the viewer shows a black screen during booting, wait for the VM to finish starting (30-60 seconds).
Controls
Mouse and keyboard
Click anywhere on the viewer to focus it. Mouse movements and keyboard input are forwarded to the VM. The viewer captures most key combinations, including Ctrl+C, Ctrl+V, and Alt+Tab.
Clipboard
To paste text into the VM:
- Copy text on your local machine.
- Click the clipboard icon in the VNC toolbar.
- Paste into the clipboard panel.
- Inside the VM, use Ctrl+V to paste.
To copy from the VM, do it in reverse: select and copy inside the VM, then grab it from the clipboard panel.
Fullscreen
Click the fullscreen icon in the VNC toolbar. Press Escape or click the icon again to exit.
Resolution
The desktop resolution adapts to your browser window size. If you resize the browser, the VM resolution adjusts to match.
Troubleshooting
| Problem | Solution |
|---|---|
| Black screen | Desktop may still be booting. Wait 30-60 seconds. |
| Frozen display | Click the viewer to refocus. If still stuck, refresh the page. |
| Input lag | Check your network connection. VNC performance depends on latency. |
| No connection | Verify the desktop status is running. If it is stopped, start it first. |
Tips
- Use the terminal for text-heavy work. It is faster than typing into a VNC session.
- If you just need to check the screen, use screenshots instead of keeping the viewer open.
- The VNC viewer works on tablets and phones, but is best on a desktop or laptop browser.