README.md

matchbox

matchbox is a service that matches bare-metal machines (based on labels like MAC, UUID, etc.) to profiles that PXE boot and provision Container Linux clusters. Profiles specify the kernel/initrd, kernel arguments, iPXE config, GRUB config, Container Linux Config, or other configs a machine should use. Matchbox can be installed as a binary, RPM, container image, or deployed on a Kubernetes cluster and it provides an authenticated gRPC API for clients like Terraform.

• Documentation
• matchbox Service
• Profiles
• Groups
• Config Templates
  • Container Linux Config
  • Cloud-Config
• Configuration
• HTTP API / gRPC API
• Background: Machine Lifecycle
• Background: PXE Booting

Installation

• Installation
  • Installing on Container Linux / other distros
  • Installing on Kubernetes
  • Running with docker
• Network Setup

Tutorials

• Getting Started - provision physical machines with Container Linux
• Local QEMU/KVM
  • matchbox with Docker
• Clusters
  • etcd3 - Install a 3-node etcd3 cluster
• Clusters (Terraform-based)
  • etcd3 - Install a 3-node etcd3 cluster

Contrib

• dnsmasq - Run DHCP, TFTP, and DNS services as a container
• terraform-provider-matchbox - Terraform provider plugin for Matchbox