Skip to content

Adding Your First Hosts

Last updated: 2026-07-23

In VordFleet, your account (tenant) is your fleet — every host you register shows up together in one dashboard. There are no separate fleet groups to create or name; you simply install the agent on each host and it enrolls into your account.

Registering a Host

Each host needs its own registration token. A token is consumed by the first host that uses it, so repeat these steps for every host you add.

  1. In the dashboard, open the Fleet tab and click Register.
  2. On the Registration Tokens page, click Create Token, give it a name (e.g., “web-01”), and click Create Token.
  3. Copy the token — it is shown only once.
  4. On your target host, run the install script with the token:
curl -fsSL https://get.vordfleet.dev | sudo bash -s -- --token YOUR_TOKEN

The agent installs as a systemd service and auto-enrolls. Your host appears in the dashboard within about a minute.

Tokens expire 7 days after they are created. An unused token past that point will be rejected — create a fresh one and run the install again.

Organizing Your Hosts

All of your hosts live in a single fleet view. You can search and filter them from the Search page under the Fleet tab — for example by hostname — so there is no need to pre-group hosts. Because each host consumes its own token, naming a token after the host it is meant for makes the Registration Tokens page easier to read while a rollout is in progress.

Host Limits by Plan

The number of hosts you can register depends on your plan:

PlanMax Hosts
Free3
ProUp to 1,000
TeamUp to 10,000

If you reach your limit, registration fails with a “Machine limit exceeded” error and the host does not enrol. Your existing hosts are unaffected. Upgrade your plan, then run the install again on the new host.