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

• Docs
• Configuration
• HTTP API / gRPC API

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