Network boot and provision CoreOS clusters on virtual or physical hardware.

Announcement: coreos-baremetal and bootcfg have been renamed to CoreOS matchbox, which will be reflected in v0.5.0. Please see CHANGES or #400. If you're looking for older docs, be sure to use the branch/tag switcher.

• Network Setup
• Machine Lifecycle
• Background: PXE Booting
• Tutorials (QEMU/KVM/libvirt)
  • matchbox with rkt
  • matchbox with Docker

matchbox is an HTTP and gRPC service that renders signed Ignition configs, cloud-configs, network boot configs, and metadata to machines to create CoreOS clusters. Groups match machines based on labels (e.g. MAC, UUID, stage, region) and use named Profiles for provisioning. Network boot endpoints provide PXE, iPXE, and GRUB. matchbox can be deployed as a binary, as an appc container with rkt, or as a Docker container.

• matchbox Service
• Profiles
• Groups
• Config Templates
  • Ignition
  • Cloud-Config
• Configuration
• HTTP API
• gRPC API
• Installation
  • CoreOS / Linux distros
  • rkt / docker
  • Kubernetes

The examples network boot and provision CoreOS clusters. Network boot QEMU/KVM VMs to try the examples on your Linux laptop.

• Multi-node Kubernetes cluster
• Multi-node rktnetes cluster (i.e. Kubernetes with rkt as the container runtime)
• Multi-node self-hosted Kubernetes cluster
• Upgrading self-hosted Kubernetes clusters
• Multi-node etcd2 or etcd3 cluster
• Network boot and/or install to disk (multi-stage installs)

Tectonic is the enterprise-ready Kubernetes offering from CoreOS (free for 10 nodes!). The Tectonic Installer app integrates directly with matchbox through its gRPC API to provide a rich graphical client for populating matchbox with machine configs.

Learn more from our docs or blog.