Skip to content

Network boot and provision Fedora CoreOS and Flatcar Linux clusters

License

Notifications You must be signed in to change notification settings

mrIncompetent/matchbox

 
 

Repository files navigation

matchbox

GoDoc Quay Workflow Downloads Sponsors Mastodon

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 Ignition config.

Features

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

Documentation

Installation

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

Tutorials

Start provisioning machines with Fedora CoreOS or Flatcar Linux.

  • Terraform Usage
    • Fedora CoreOS (PXE install to disk)
    • Flatcar Linux (PXE install to disk)
  • Local QEMU/KVM
    • Fedora CoreOS (live PXE or PXE install to disk)
    • Flatcar Linux (live PXE or PXE install to disk)

Contrib

About

Network boot and provision Fedora CoreOS and Flatcar Linux clusters

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Go 90.6%
  • Shell 6.9%
  • Makefile 2.2%
  • Dockerfile 0.3%