Getting Started
The VDO remote desktop agent lets you access your Linux machine from any modern web browser. Once installed, your machine appears in your VDO dashboard and you can connect to it with a single click -- no VPN, no port forwarding, and no additional software on the client side.
System Requirements
| Requirement | Details |
|---|---|
| Architecture | x86_64 (64-bit Intel or AMD) |
| OS | Rocky Linux 8 or 9, Fedora 42, Ubuntu 22.04 or 24.04 |
| Desktop | GNOME, KDE, or any X11-based desktop environment |
| GPU (recommended) | NVIDIA (Maxwell or newer), AMD, or Intel with VA-API support |
| Network | Outbound internet access (no inbound ports required) |
| RAM | 512 MB available for the agent |
A dedicated GPU is recommended for the best experience but is not required. The agent will fall back to CPU-based encoding if no supported GPU is detected.
Quick Install
From your VDO dashboard, go to Machines > Install and copy the one-line install command. It looks like this:
curl -fsSL https://api.vdostream.io/api/v1/remote/install.sh | sudo bash -s -- --token YOUR_TOKEN
Run it in a terminal on the machine you want to access. The installer will:
- Download the correct
vdo-remote-agentbinary for your system - Set up the agent as a system service
- Install the privileged KMS grab helper when it is bundled or available for your build
- Configure permissions for display capture and input
- Register the machine with your VDO account
After installation, your machine will appear in the dashboard within a few seconds.
First Connection
- Open vdostream.io and sign in
- Go to Machines
- Your newly installed machine should show as Online
- Click Connect
You should see your Linux desktop appear in the browser. Move the mouse and type to confirm input is working. The toolbar at the top of the viewer gives you access to display switching, quality settings, and session controls.