Skip to content

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.

    Read

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.

    Start

  • 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.

    Start

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.

    Read

  • Decisions before you install


    Secure Boot, the control planes, the VIP, the secrets file and the platform: each choice with its consequence.

    Read

  • Releases


    The images, the installer and chalkctl a release publishes, when to use its generic images, and how to pin and verify them.

    Read