Troubleshooting
Machine shows offline
systemctl --user status vdo-agent
If not running, start it. Check network access:
curl -s https://api.vdostream.io/health
Black screen
The agent needs an active desktop session. On headless machines, ensure auto-login is configured. Try restarting the display manager:
sudo systemctl restart gdm
systemctl --user restart vdo-agent
For headless machines without a dongle, see Configuration & Display.
No keyboard or mouse
Restart the agent:
systemctl --user restart vdo-agent
If that doesn't help, re-run the installer to reset permissions.
Poor quality or stuttering
Check your encoder -- hardware encoding gives the best results:
vdo-remote-agent --probe
If only CPU encoding is available, install GPU drivers. Try a lower quality preset (WAN or Speed) in the viewer toolbar.
Audio not working
Ensure PipeWire or PulseAudio is running:
systemctl --user status pipewire
Install if missing:
# Rocky / Fedora
sudo dnf install pipewire pipewire-pulseaudio
systemctl --user enable --now pipewire
# Ubuntu
sudo apt install pipewire pipewire-pulse
systemctl --user enable --now pipewire