Skip to content

Installing the VordFleet Agent

Last updated: 2026-07-23

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, open the Fleet tab, and click Register.
  2. On the Registration Tokens page, click Create Token and copy the token (shown once).
  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 vord-agent

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

sudo journalctl -u vord-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.