Get started¶
These pages are for readers new to chalkos. They explain the model of a cluster, run a lab cluster or a lab router on one machine and list what real machines need. The guides go on to a cluster on real machines.
Understand chalkos¶
This page explains the model of a cluster before any command.
-
What is chalkos
What chalkos builds and what sets it apart, the model of a cluster from the images and the config documents to an upgrade, and how chalkos compares with Talos and NixOS.
Quick starts¶
Each quick start runs a lab of virtual machines on one machine in about 15 minutes.
-
Quick start: Kubernetes
Run a cluster of two QEMU virtual machines on one machine with chalklab, upgrade it and remove it, in about 15 minutes.
-
Quick start: router
Run a router and a client on its LAN as QEMU virtual machines, check its DHCP, DNS and masquerade, and change its firewall on trial, in about 15 minutes.
Before you install¶
These pages prepare an install on real machines.
-
Requirements
What chalkos needs from machines, firmware, disks and networks, and what a lab needs from its host.
-
Decisions before you install
Secure Boot, the control planes, the VIP, the secrets file and the platform: each choice with its consequence.
-
Releases
The images, the installer and chalkctl a release publishes, when to use its generic images, and how to pin and verify them.