Skip to content

Fleet documentation

How the self-hosted fleet is built and run, and what each of its tools does. Documentation that belongs to a single repo stays in that repo's README.

If the fleet's tools are new to you, start with The fleet at a glance.

Section What it covers
Fleet bootstrap Building the self-hosted fleet from nothing: the order hosts come up in, the procedures they share, and each host's runbook
Tools A primer for each tool the fleet is built from, how-tos for common changes, and a glossary
Standards The Markdown style guide every repo here follows

The repos

Repo Holds Visibility
fleet-stacks Every container and stack definition, deployed through Komodo Public
fleet-ansible The run that builds a VM from nothing to running stacks, plus the roles that configure the Proxmox hosts Public
fleet-opentofu The OpenTofu configuration that creates each VM, blank, with the installer ISO in its CD drive Public
fleet-nixos The flake that holds every VM's NixOS configuration, the installer ISO, and the commands that install and deploy a host Public
fleet-private The real inventory, the private values, and the encrypted secrets the public repos run against Private
fleet-docs This site Public