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 the following command to understand how to download a Talos Omni ISO image:
omnictl download iso --help
For example, to download a Talos Omni ISO image with an amd64 architecture, run:
omnictl download iso --arch amd64

​
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. 
      diskutil list
      ...
      /dev/disk2 (internal, physical):
         #:                       TYPE NAME                    SIZE       IDENTIFIER
         0:                                                   *31.9 GB    disk2
      ...
In this example disk2 is the USB drive.
      dd if=<path to ISO> of=/dev/disk2 conv=fdatasync

​
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.