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 with a single click -- no VPN, no port forwarding, no additional software on the client side.
Requirements
| Architecture | x86_64 (64-bit Intel or AMD) |
| OS | Rocky Linux 8/9, Fedora 42+, Ubuntu 24.04+ |
| Desktop | GNOME, KDE, or any X11 desktop environment |
| GPU (recommended) | NVIDIA (Maxwell+), AMD, or Intel with VA-API |
| Network | Outbound internet access |
A GPU is recommended but not required. The agent falls back to CPU encoding automatically.
Installation
From your VDO dashboard, go to Machines > Install and copy the install command:
curl -fsSL https://api.vdostream.io/api/v1/remote/install.sh | sudo bash -s -- --token YOUR_TOKEN
The installer downloads the agent, sets up the service, configures permissions, and registers the machine. It takes about a minute.
Choosing an OS build
The installer auto-detects your distribution. To specify explicitly: