Register a Bare Metal Machine (PXE/iPXE)
A guide on how to register a bare metal machines with Omni using PXE/iPXE.
Last updated
A guide on how to register a bare metal machines with Omni using PXE/iPXE.
Last updated
This guide shows you how to register a bare metal machine with Omni by PXE/iPXE booting.
Upon logging in you will be presented with the Omni dashboard. Click the “Copy Kernel Parameters” button on the right hand side, and save the value for later.
The following example assumes the use of Matchbox server.
Download vmlinuz
and initramfs.xz
from the of your choice (Talos Linux 1.4 or greater is required), and place them in /var/lib/matchbox/assets
.
Place the following in /var/lib/matchbox/profiles/default.json
:
Update siderolink.api
, talos.events.sink
, and talos.logging.kernel
with the kernel parameters copied from the dashboard.
Place the following in /var/lib/matchbox/groups/default.json
:
Once your machine is configured to PXE boot using your tool of choice, power the machine on.
Navigate to the “Machines” menu in the sidebar of Omni. You should now see a machine listed.
You now have a bare metal machine registered with Omni and ready to provision.