Homelab

The physical infrastructure substrate: hardware, network mesh, and host configuration that every planet runs on.

STATUS: Early0 ARCHITECTURE DECISIONSLAST UPDATED: 2026-10-10

Homelab is the physical layer beneath all software planets. It documents the UM890 Pro hardware, Tailscale mesh topology, NAS storage layout, and systemd host configuration, and runs scheduled, restore-tested backups of the monorepo's small state with an encrypted off-site copy. Not a deployable service but a governed substrate. Tasks touching homelab govern the machine, not the monorepo.

Overview

Homelab is the physical layer beneath every software planet. It documents the hardware, network mesh, storage, and host configuration that all other planets depend on: a governed substrate rather than a deployable service.

Architecture

A single MINISFORUM UM890 Pro host: AMD Ryzen 9 8945HS, 64 GB DDR5, NVMe for the monorepo and runtime state, with network-attached storage for datasets and models. Machines are joined by a Tailscale mesh, and services are supervised by systemd and Docker at the host level. No ports, no containers of its own.

Problem It Solves

Infrastructure decisions made once and never written down become invisible constraints that surface as outages. Recording the hardware, mesh topology, and host configuration makes the substrate every planet runs on inspectable rather than assumed.

Current State

In Progress. The substrate is documented and still being extended: hardware, network, storage, and host configuration are recorded, DNS runs on Cloudflare, and scheduled, restore-tested backups of the monorepo's small state run with an encrypted off-site copy. Tasks touching homelab govern the machine, not the monorepo.

MILESTONES

4 milestones
2026