matchbox/docs/index.md

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 Container Linux or Fedora CoreOS config.

Features

• Chainload via iPXE and match hardware labels
• Provision Container Linux and Fedora CoreOS (powered by Ignition)
• Authenticated gRPC API for clients (e.g. Terraform)

Installation

Matchbox can be installed from a binary or a container image.

• Install Matchbox on Kubernetes, on a Linux host, or as a container
• Setup a PXE-enabled network

Tutorials

Getting started provisioning machines with Container Linux.

• Local QEMU/KVM
  • matchbox with Docker
• Clusters
  • etcd3 - Install a 3-node etcd3 cluster
  • etcd3 - Install a 3-node etcd3 cluster (terraform-based)

Related

• dnsmasq - container image to run DHCP, TFTP, and DNS services
• terraform-provider-matchbox - Terraform provider plugin for Matchbox
• Typhoon - minimal and free Kubernetes distribution, supporting bare-metal