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

2.2 KiB Raw Blame History