Homelab

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

STATUS: In Progress0 ARCHITECTURE DECISIONSLAST UPDATED: 2026-07-22

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. Not a deployable service — 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 mounted at /mnt/warehouse 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. Phase 1 documentation is complete — hardware, network, storage, and host configuration are recorded. Tasks touching homelab govern the machine, not the monorepo.

MILESTONES

2 milestones
2026