diff --git a/public/omni/omni-cluster-setup/registering-machines/register-a-bare-metal-machine-pxe-ipxe.mdx b/public/omni/omni-cluster-setup/registering-machines/register-a-bare-metal-machine-pxe-ipxe.mdx index 9abf8655..9db3af21 100644 --- a/public/omni/omni-cluster-setup/registering-machines/register-a-bare-metal-machine-pxe-ipxe.mdx +++ b/public/omni/omni-cluster-setup/registering-machines/register-a-bare-metal-machine-pxe-ipxe.mdx @@ -2,6 +2,8 @@ title: Register a Bare Metal Machine (PXE/iPXE) --- +import { release } from '/snippets/custom-variables.mdx'; + This guide shows you how to register a bare metal machine with Omni by PXE/iPXE booting. ### Copy the required kernel parameters @@ -58,8 +60,27 @@ 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. -### Conclusion - 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. + +## Alternative option: Use a hosting provider that supports iPXE with DHCP + +Some bare metal hosting providers (for example, managed dedicated server providers) already provide DHCP and an iPXE boot environment. + +In these cases, you don’t need to run your own PXE stack (such as Matchbox or Booter). Instead, you can chainload Talos directly from the Talos Image Factory. + +Use the following minimal iPXE script: + +```ipxe +#!ipxe +dhcp +chain --replace --autofree https://pxe.factory.talos.dev/pxe///metal-amd64 +``` + +Replace: + +- `` with the schematic ID generated in Image Factory +- `` with the Talos version you want to boot (for example, {release}) + +After the machine boots, it will register with Omni using the kernel parameters configured in Image Factory.