Managing the Agent

The agent runs as a user-level systemd service that starts automatically on login and persists across reboots.

Checking Status

systemctl --user status vdo-agent

This shows whether the agent is running, its uptime, and recent log output.

Viewing Logs

Follow live logs:

journalctl --user -u vdo-agent -f

View recent logs:

journalctl --user -u vdo-agent --since "1 hour ago"

The installer also writes the agent process output to:

tail -200 /tmp/vdo-agent-systemd.log

Use this file when journalctl --user only shows systemd wrapper messages.

Restarting

systemctl --user restart vdo-agent

A restart takes a few seconds. Any active sessions will be disconnected and the machine briefly shows as offline before reconnecting.

Stopping

systemctl --user stop vdo-agent

The machine will show as offline in the dashboard. It will not restart until you start it manually or reboot.