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)

Documentation

Docs
Configuration
HTTP API / gRPC API

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)

Contrib