Inventory & Groups
Host Groups
inventory.yml defines these groups:
desktop
Workstations and laptops with a full desktop environment (GNOME, browsers, etc.).
desktop:
hosts:
mumbai: # Debian VM on the phone (cli-only, skips desktop roles)
kerala: # postmarketOS ARM device
kanpur: # Laptop
himachal: # Laptop (runs hive_ops)
dilli: # Secondary desktop
Desktop roles: flatpak, gnome, zen_browser, bluefin_common, pipewire_audio, kube
server
Headless hosts.
server:
hosts:
punjab: # agent box, KubeVirt VM on karnataka (100.103.187.46)
vm: # Local dev VM
goa: # Raspberry Pi 5 (ARM)
Server roles: server_hardening, plus the service roles.
vps
The inventory lists two retired Hetzner VPSes, formerly migrated to the AWS Talos cluster, which was terminated on 2026-10-25. Restart nothing on these hosts; follow the Matrix cutover runbook before touching either. Active spindle is an OCI Frankfurt VPS running Matrix and standalone LiveKit; it is not in this inventory.
vps:
hosts:
matrix: # Retired — former Matrix homeserver
telengana: # Retired — hosted the Hive on k3s
vps members skip syncthing, proxy and tailscale_cert, and get
server_hardening. group_vars/vps.yml is currently empty.
test_fleet
KubeVirt VMs reached via virtctl port-forward (see the host's host_vars).
Both set machine_profile: vm-test, which skips desktop and service roles.
test_fleet:
hosts:
test-fleet-fedora:
test-fleet-node2:
termux_hosts
The raw Termux/Android layer on the phone. Gates the termux_packages role.
termux_hosts:
hosts:
termux:
llm (dormant)
Commented out in inventory.yml — karnataka, its former member, now runs k3s workloads.
Not in the inventory
bihar is in the desktop group (Bluefin, bootstrapped 2026-11-17).
karnataka is configured from the native-units branch
(#348) and is not listed here.
Neither is a Talos node any more; see Fleet status. spindle is
not in the inventory. The terminated AWS cluster's nodes were not in the inventory either.
Per-Machine Configuration
Each machine has a host_vars/<name>.yml file with common knobs:
is_laptop: true # Laptop (runs on login, not timer)
skip_flatpak: true # Skip Flatpak installs
skip_gnome: true # Skip GNOME config
skip_kube: true # Skip kubeconfig deploy
skip_proxy: true # Skip Caddy proxy
machine_profile: cli-only # Free-form profile; `vm-test` skips desktop + service roles
web_services: [] # Service links for the local dashboard
The full set of skip_* flags site.yml honours: skip_sudo, skip_ssh_mesh,
skip_kube, skip_forgejo, skip_flatpak, skip_bluefin, skip_gnome,
skip_zen_browser, skip_pipewire_audio, skip_syncthing, skip_systemd,
skip_proxy, skip_tailscale_cert.
Group Variables
group_vars/all.yml— Homebrew package lists, Flatpak remotes, Firefox Accounts config, GNOME extensions, authorized SSH keysroles/flatpak/vars/main.yml— thesystem_flatpakslistgroup_vars/vps.yml— currently empty