Skip to content
Trailer.devDocumentation

Host Details

The Host Details page header with status, action buttons and the configuration sections in the sidebar.

View and configure a single host. The header shows the host name, a live online / offline status indicator, and the create and update timestamps.

The form is split into the sections listed in the local sidebar:

  • Basic information
  • Image building
  • Registry auths: credentials for pulling and pushing to private registries.
  • Reverse proxy: none, Traefik via Docker labels, or Traefik via config files.
  • Nvidia driver: optional driver and container toolkit deployment.
  • GPU monitor
  • Traefik: optional managed Traefik deployment, including its image, network, ports and config.
  • Intervals and timeouts: heartbeat and reconciliation intervals, plus pull, push and build timeouts.
  • Resources
  • Network interfaces: the NICs the agent reports, used as macvlan parent interfaces.
  • Metrics collection: toggles and retention for host, GPU and workspace metrics.
  • Domains
  • Permissions

The header action buttons depend on the host state and your permissions:

  • Enable / Disable: toggles whether the host accepts work.
  • Delete: available only when the host is disabled.
  • Logs: opens a streamed log terminal for the host. Available when the host is online.
  • Monitor: opens the host resource monitor. Available when the host is online.
  • GPU info: shown when the host reports GPUs.

The Permissions section grants per-user, host-level capabilities. Each user row has these flags:

  • View: see the host.
  • Create workspaces
  • Create images
  • Create bind mounts
  • Create volume mounts
  • Create networks

These flags gate which hosts a user can target when creating the matching resources. For example, creating a volume requires Create volume mounts (or Create bind mounts for a bind volume), and creating a network requires Create networks. The mount flags also gate editing existing volumes on the host. Only admins manage host permissions. See Permissions and access control for the full model.