Skip to content

Installing the VordFleet Agent

Last updated: 2026-04-22

The VordFleet agent is a lightweight process that runs on each host in your fleet. It collects system metrics, monitors security events, and reports health status back to the VordFleet dashboard.

Prerequisites

  • A VordFleet account (the free tier works)
  • A Linux host running Ubuntu 20.04+, Debian 11+, or RHEL 8+
  • Root or sudo access on the target host

Installation

  1. Log in to the VordFleet dashboard and navigate to Settings > Fleet Token.
  2. Copy your fleet token.
  3. On your target host, run the install script:
curl -fsSL https://get.vordfleet.dev | sudo bash -s -- --token YOUR_TOKEN

The agent installs as a systemd service and starts automatically. Your host should appear in the dashboard within 60 seconds.

Verifying the Installation

Check the agent status with:

sudo systemctl status vordfleet-agent

You should see active (running) in the output. If the agent is not running, check the logs:

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

Supported Platforms

OSMinimum Version
Ubuntu20.04 LTS
Debian11 (Bullseye)
RHEL / CentOS8
Amazon Linux2023

Windows and macOS support is planned for a future release.