mirror of
https://github.com/outbackdingo/matchbox.git
synced 2026-01-27 10:19:35 +00:00
1484cf7354
Some commands were added in the ipxeBootstrap to enable architecture detection based on the architecture the iPXE version used was built for. This is done through the use of an additional flag in the chain which is the ipxeBootstrap using the buildarch parameter.
matchbox
matchbox is a service that matches bare-metal machines to profiles that PXE boot and provision clusters. Machines are matched by labels like MAC or UUID during PXE and profiles specify a kernel/initrd, iPXE config, and Ignition config.
Features
- Chainload via iPXE and match hardware labels
- Provision Fedora CoreOS or Flatcar Linux (powered by Ignition)
- Authenticated gRPC API for clients (e.g. Terraform)
Documentation
Installation
Matchbox can be installed from a binary or a container image.
- Install Matchbox as a binary, as a container image, or on Kubernetes
- Setup a PXE-enabled network
Tutorials
Start provisioning machines with Fedora CoreOS or Flatcar Linux.
- Terraform Usage
- Fedora CoreOS (PXE install to disk)
- Flatcar Linux (PXE install to disk)
- Local QEMU/KVM
- Fedora CoreOS (live PXE or PXE install to disk)
- Flatcar Linux (live PXE or PXE install to disk)
Contrib
- dnsmasq - Run DHCP, TFTP, and DNS services as a container
- terraform-provider-matchbox - Terraform provider plugin for Matchbox