Hosts

The Hosts page lists the agents registered with this server. A host is a machine running the Trailer agent. Hosts are not created from the UI. They self-register when the agent connects to the server, so there is no “new host” button here.

The table

The table shows one row per host with these columns:

Name: a link to the host details.
Status: online or offline.
Environment: docker or kubernetes.
Enabled: whether the host accepts work.
CPU, Memory, GPUs: reported resources.
Last update

You can search by name, sort by name, status, environment, enabled, or last update, and page through results.

Actions

Hosts can be enabled or disabled, and deleted. A host must be disabled before it can be deleted. These actions are available per host and as batch actions over a selection.

Enabling and disabling

A disabled host accepts no work. When you disable a host, on its next reconciliation the agent stops every workspace running on it: each moves to Stopping and then Stopped. While a host stays disabled nothing is deployed, updated, or cleaned up on it.

Stopping a workspace this way does not delete it. The containers and their attached volumes are kept, so enabling the host again and letting it reconcile brings the workspaces back to their intended state, and any workspace set to auto start begins running again. A host must be disabled before it can be deleted.

Licensing and the host limit

Running a single host needs no license. As soon as more than one host is registered with the server, a valid license key must be configured.

When more than one host is registered without a valid license, every host except the oldest-registered one is automatically disabled as it checks in. A disabled host stops all of its workspaces, as described under Enabling and disabling. The oldest host keeps working normally, and the server itself keeps running.

Hosts disabled this way stay disabled after a license is configured. Re-enable them from this page once the license is in place. Re-enabling an extra host without a valid license does not stick: it is disabled again the next time it checks in. Registering a brand-new host beyond the first also requires a valid license and is refused without one. See the Configuration Reference for where the license key is set.