Skip to content

Machines

The Machines page is the main landing page of the dashboard. It lists every machine registered with your account and provides the Bootstrap button to add new machines.

Machines list page

Table Columns

Column Description
Hostname The machine's hostname. Includes a colored dot indicating online (green) or offline (red) status. May also display badges for eBPF support and pending configuration changes.
Provision Current provisioning state of the machine. Common values: Discovery mode (newly registered, awaiting configuration), Install pending, Installing, Installed, Failed.
Mesh Network The mesh network the machine belongs to, if any.
Roles Tags showing the machine roles assigned to this machine.

Each row also has a three-dot menu on the right for actions such as delete.

Clicking a hostname navigates to the machine detail page.

Online and Offline Status

Each machine's hostname is preceded by a colored status dot:

  • Green dot — The machine is online. The agent has sent a heartbeat within the last 60 seconds.
  • Red dot — The machine is offline. The dot is accompanied by a time label showing how long ago the machine was last seen (for example, "4d" means 4 days ago).

Bootstrap Button

The Bootstrap button in the top-right corner opens the Bootstrap Machine dialog. This dialog lets you generate credentials to register a new machine with the control plane.

There are three bootstrap methods. Select one by clicking its card at the top of the dialog.

Durantic CLI

The fastest method for machines with an existing Linux installation and internet access.

Bootstrap via Durantic CLI

How it works:

  1. Select the Token Lifetime from the dropdown. The default is 10 minutes. Other options: 1 day, 7 days, 30 days, 90 days, 365 days.
  2. Copy the one-line curl command displayed in the dialog. The command downloads and runs the Durantic install script with an embedded JWE bootstrap token.
  3. Run the command as root on the target machine.
  4. Click Done to close the dialog.

The command looks like:

curl -sfL https://api.durantic.io/install.sh | DURANTIC_TOKEN=<token> sh

ISO Image

Best for machines that need to be booted from removable media or a virtual CD-ROM.

Bootstrap via ISO Image

How it works:

  1. Click Download ISO Image to download the Durantic bootstrap ISO.
  2. Write the ISO to a USB drive or mount it as a virtual CD-ROM, then boot the target machine from it.
  3. The machine displays a 6-character bootstrap code on its console after booting.
  4. Enter that 6-character code in the dashboard dialog (three characters, dash, three characters).
  5. Click Bootstrap to complete registration.

PXE/Network

For environments with existing PXE boot infrastructure (TFTP, HTTP, or NFS servers).

Bootstrap via PXE/Network

How it works:

  1. Click the vmlinuz and initrd download buttons to get the kernel and initial ramdisk files.
  2. Place these files on your PXE server (TFTP, HTTP, or NFS).
  3. Configure your PXE boot menu to boot from these files, passing the bootstrap token as a kernel parameter.
  4. Select the Token Lifetime and copy the generated token from the dialog.
  5. Click Done to close the dialog.

After Bootstrap

Once a machine successfully bootstraps, it appears in the Machines list in Discovery mode. From here you can:

  1. Click the machine hostname to open its detail page.
  2. Assign machine roles and a mesh network.
  3. Trigger provisioning to install the operating system and apply configuration.