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