🖥️Fleet

  • Every host in the homelab. Each has a page under Fleet/ carrying its hardware sheet — vendor, model, serial, CPU, RAM, storage, firmware — and its physical quirks.

  • Roles, cluster membership, and node addresses are not recorded here. Hosts are declared in flake.nix; network facts live in the topology SSOT described on Architecture/Kubernetes. Read those.

  • Kubernetes nodes

  • Raspberry Pis

  • Microcontroller

    • HostPurposeHardware
      Fleet/eviropicoenvironment sensorPi Pico W, Pimoroni Enviro+
  • Cloud

    • HostWhereHardware
      Fleet/oldboyGCE, homelab-ng projecte2-micro, free tier
    • When provisioned, its shielded_instance_config gives Fleet/oldboy a GCE vTPM; see the divergence below.

  • Reaching hosts

    • LAN hosts resolve as <host>.lolwtf.ca.

    • Fleet/weatherpi4 and the offsite nodes require the tailnet.

    • Kubernetes nodes have Tailscale disabled — reach them over the LAN or through the cluster.

  • Known divergence

    • Git is the source of truth for this fleet; these hosts differ from what the repo declares, and each difference is a bug to close.

    • Fleet/cloudpi4 runs Ubuntu. Its NixOS config exists and is unapplied.

    • Fleet/radiopi0 runs Raspbian. Its NixOS config carries no radio service; the armv6l closure builds but the service is not ported.

    • Fleet/blinkypi0 is unplugged. Its NixOS config carries no device service and its device code is not in git.

    • Fleet/eviropico is unplugged. Its MicroPython code is not in git.

    • Fleet/oldboy is not provisioned. Its Terraform and NixOS config exist but no live instance runs; needs to be brought back.

Sub-pages

Linked references 8

Runbooks/Deploy a NixOS Host

Use this when building, deploying, or rolling back a NixOS host from this repo. Host inventory lives in Fleet; architecture background lives in Architecture/NixOS.

Architecture/Networking

Networking spans all four layers: UniFi VLANs and BGP at Layer 1/3 (terraform/network/), Cilium and the Gateway API inside each cluster at Layer 2 (clusters/*/networking/), Cloudflare and Tailscale gluing sites together at Layer 3. This page is the single place the whole story lives. Cluster composition is on Architecture/Kubernetes; host hardware is on Fleet; live discovery of the running UniFi controller is the unifi-network skill (Runbooks/Inspect UniFi Network).

Architecture/GitOps

Step-by-step: Runbooks/Deploy a NixOS Host. Host inventory: Fleet. Layer background: Architecture/NixOS.

Architecture/Kubernetes

Hardware, serials, and per-host quirks for all five nodes: Fleet.

Architecture

Fleet — the concrete hosts all of this runs on

Architecture/NixOS

Layer 1: bare metal. Every host in the fleet is declared as NixOS in one flake at the repo root (flake.nix), configured under nix/. A few hosts run something else and are being brought across — Fleet lists the machine inventory and the known divergence. Runbooks/Deploy a NixOS Host has the build/deploy/rollback commands; this page is architecture only.

Home

Fleet — every host, its hardware, and its quirks

2026-07-08

Seeded Architecture (all four layers plus networking, secrets, and GitOps), Fleet, and Runbooks.