CoreOS on Baremetal

Guides and a service for network booting and provisioning CoreOS clusters on virtual or physical hardware.

Announcement: coreos-baremetal and bootcfg are being 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.

Guides

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

matchbox

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

Examples

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
• Multi-node Torus distributed storage cluster
• Network boot and/or install to disk (multi-stage installs)

Enterprise

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.