Skip to content
VordFleet

Agent Troubleshooting

Last updated: 2026-04-22

If your VordFleet agent is not reporting correctly, use these steps to diagnose and fix the issue.

Agent Not Appearing in Dashboard

  1. Check the service is running:
sudo systemctl status vordfleet-agent

  1. Verify the fleet token is correct in /etc/vordfleet/agent.conf.

  2. Check network connectivity — the agent needs outbound HTTPS access to api.vordfleet.dev on port 443.

  3. Review the logs:

sudo journalctl -u vordfleet-agent --no-pager -n 100

Agent Showing as Offline

If the agent was previously connected but now shows offline:

  • Check if the host rebooted — the agent should restart automatically via systemd.
  • Check disk space — if the root partition is full, the agent may fail to write its state file.
  • Check DNS resolution — ensure api.vordfleet.dev resolves correctly.

Updating the Agent

To update to the latest agent version:

curl -fsSL https://get.vordfleet.dev | sudo bash -s -- --update

The agent restarts automatically after the update.

Uninstalling the Agent

To remove the agent completely:

sudo systemctl stop vordfleet-agent
sudo systemctl disable vordfleet-agent
sudo rm -rf /etc/vordfleet /usr/local/bin/vordfleet-agent
sudo rm /etc/systemd/system/vordfleet-agent.service
sudo systemctl daemon-reload

The host will appear as offline in the dashboard. You can remove it from the host detail page.

← Back to Support