Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

Matchbox

github.com

  • Free plan
  • Linux
  • API
  • Self-hosted
6.7 Club score Visit github.com

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

Matchbox

Free

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.