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 |