Matchbox
github.com
- Free plan
- Linux
- API
- Self-hosted
What Matchbox is
Matchbox is a free, self-hosted service that matches bare-metal machines to profiles for PXE booting and cluster provisioning. It provisions Fedora CoreOS or Flatcar Linux through Ignition configuration and can identify machines by labels such as MAC address or UUID. Matchbox chainloads with iPXE and renders network boot configuration for iPXE and GRUB2 clients. HTTP endpoints and an authenticated gRPC API let clients create or update resources; TLS credentials provide gRPC authentication and secure communication. Terraform usage is documented, with a Matchbox provider plugin available. The service runs as a Linux binary, container image, or Kubernetes deployment. Poseidon also provides dnsmasq as a container for DHCP, TFTP, and DNS services. The maker describes use in labs or datacenters. Installation guidance includes verifying release signatures with its GPG key. Kubernetes examples use ephemeral storage and recommend persistent storage when available.
Who it suits
Matchbox suits infrastructure teams provisioning bare-metal client machines in labs or datacenters. It is intended for self-hosted Linux, container, or Kubernetes deployments using network boot workflows.
Good to know, and what to watch
- Matches machines using MAC addresses or UUIDs
- Provisions Fedora CoreOS and Flatcar Linux
- Supports iPXE and GRUB2 network booting
- Offers authenticated gRPC and HTTP APIs
- Runs as binary, container, or Kubernetes deployment
- Example Kubernetes manifests use ephemeral storage
- Requires replacing emptyDir with persistent storage when available
Plans
Every plan and priceMatchbox
Free plan
The verdict
Matchbox provides profile-based bare-metal provisioning with network boot support and several deployment options. Teams should account for storage configuration when adapting the Kubernetes examples.
What the maker publishes
- APIs
- Matchbox provides HTTP endpoints and an authenticated gRPC API for clients to create or update resources. source
- Audience
- The maker describes Matchbox as serving client machines in a lab or datacenter. source
- Boot support
- Matchbox can chainload via iPXE and render network boot configuration for iPXE and GRUB2 clients. source
- Deployment
- The service can run as a Linux binary, a container image, or on a Kubernetes cluster. source
- Hardware matching
- Machines can be matched to profiles by hardware labels such as MAC address or UUID. source
- Integration
- The maker documents Terraform usage and provides a Terraform provider plugin for Matchbox. source
- Operational limit
- The example Kubernetes manifests use ephemeral emptyDir storage, and the guide recommends replacing it with persistent storage when available. source
- Provisioning
- It provisions Fedora CoreOS or Flatcar Linux using Ignition configuration. source
- Purpose
- Matchbox matches bare-metal machines to profiles for PXE booting and provisioning clusters. source
- Related tools
- Poseidon provides dnsmasq as a container for DHCP, TFTP, and DNS services. source
- Release verification
- The installation guide instructs users to verify release signatures with the maker's GPG signing key. source
- Security
- The gRPC API uses TLS credentials for client authentication and a secure communication channel. source
Checked against the maker's pages on 7 Oct 2026.