Skip to main content
To provision a bare metal machine in Omni, you would have to, download the Talos Omni ISO image and then boot your bare metal machine with this image. This guide breaks the action of registering a bare metal machine into three steps:
  1. Download the Talos Omni ISO image
  2. Write the ISO to a USB stick
  3. Boot the bare metal machine using the USB stick

​
Step 1: Download the Talos Omni ISO image

You can download the Talos Omni ISO image either via the CLI or the Omni UI. To do so:
Run these commands to create a preset and download a bare metal Talos Omni ISO image:
Presets persist in Omni after the image is downloaded. When you no longer need the preset, delete it:

​
Step 2: Write the ISO to a USB Stick

After downloading the ISO image, you can boot your machine using a physical USB drive or mount the ISO remotely using out-of-band management tools — which is common in data center environments where physical access is limited.
If your server supports out-of-band management (e.g., iDRAC, iLO, IPMI), you can mount the ISO as virtual media instead of using a physical USB drive. Refer to your hardware vendor’s documentation for instructions.
To use a physical USB drive, plug it into your local machine, then identify the device path of the USB drive and write the ISO image to it.
In this example disk2 is the USB drive.

​
Step 3: Boot the machine

With your bootable USB drive ready, plug it into the machine you want to register and power it on. During startup, you will see Talos Linux logs on the console indicating that the machine is reachable via an IP address.
Machines must be able to connect outbound (egress) with UDP to your Omni account’s WireGuard port or TCP port 443 if you’re using HTTP/2 tunneling.
Once the machine has booted, go to the Machines menu in the Omni sidebar. Your machine should now appear in the list. Your bare metal machine is now successfully registered with Omni and ready to be provisioned.