<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/"><channel><title>Homelab on From The Architect</title><link>https://fromthearchitect.dev/tags/homelab/</link><description>Recent content in Homelab on From The Architect</description><image><title>From The Architect</title><url>https://fromthearchitect.dev/og-image.png</url><link>https://fromthearchitect.dev/og-image.png</link></image><generator>Hugo</generator><language>en-us</language><lastBuildDate>Sat, 14 Nov 2026 00:00:00 +1100</lastBuildDate><atom:link href="https://fromthearchitect.dev/tags/homelab/index.xml" rel="self" type="application/rss+xml"/><item><title>A Homelab Built in a Week, With Claude as the Engineer</title><link>https://fromthearchitect.dev/posts/agent-run-homelab-one-week/?utm_source=rss</link><pubDate>Sat, 14 Nov 2026 00:00:00 +1100</pubDate><guid>https://fromthearchitect.dev/posts/agent-run-homelab-one-week/</guid><description>Three weeks of planning in markdown, then 574 commits in a week: one Proxmox mini PC, a VM per job, Komodo deploying from git, and Claude doing most of the typing.</description><content:encoded><![CDATA[<p>I started this for a few reasons. The first is control over what I run and how it runs. I&rsquo;m sick of certain companies making wholesale decisions about things I use, and running them myself is how I get a say.</p>
<p>The other two reasons are closer to work. Building a platform end to end on my own hardware is a learning exercise that feeds straight back into my architecture work. And I wanted to see how far I could push Claude, and whether an LLM can really work autonomously.</p>
<p>Before this started, the house ran on two boxes. Home Assistant lived on a Raspberry Pi. Plex and the download apps ran in Container Manager on a Synology DS918+. None of it was code. It was all clickops, and if something changed, it changed because I clicked it.</p>
<p>The plan to replace that is dated 17 October 2026. The repo that built it had its first commit on 9 November. By 6 pm on the 14th there were 574 commits on <code>main</code>, nine VMs, a CI runner on a network of its own, and an agent that can take a GitHub issue through design, build and review in containers. Claude wrote almost all of it. This series is about how that went, and part one is the boring but necessary bit: what got built, and the decisions it rests on.</p>
<h2 id="three-weeks-on-paper">Three weeks on paper</h2>
<p>For three weeks nothing ran. The plan was a markdown file dated 17 October, and the server, a Minisforum MS-03, was bought a week later. Over the next four days came every service with where it runs and how it&rsquo;s deployed, the policy for which updates merge themselves, the VM names, and a clean-sheet network design.</p>
<p>The plan&rsquo;s goals were one machine running every VM, the Pi retired, and the media devices off Wi-Fi, with local voice control in each room and a self-hosted assistant further out. Neither of those exists yet. The services doc added the other aim: replace paid services where a self-hosted one is good enough, so Immich for photos, Paperless for documents and Audiobookshelf for audiobooks.</p>
<p>The MS-03 arrived barebone, so RAM and NVMe were separate purchases. It has a Core Ultra 9 386H, 64 GB, two NVMe drives as a ZFS mirror, and two 10G SFP+ ports. Reviews put it at about 14 W idle, which matters for something that never turns off. My own measurement came out nearer 34 W, and the small case matters too, as part four will show.</p>
<p>The services document is the one that did the most work. It lists every app with who uses it, what it needs and where it runs, and its &ldquo;Dropped&rdquo; table is as useful as the rest. Pi-hole is out because NextDNS already filters at the gateway. Vaultwarden is out because 1Password covers it. Metabase is out because Grafana and Claude between them answer the same questions without a 2 GB Java process.</p>
<h2 id="the-shape-of-it">The shape of it</h2>
<p>The naming rule went in on 27 October: every machine, physical or virtual, is named after a mythical creature whose myth hints at its job. The server is a Proxmox VE host called hydra, because it&rsquo;s many heads on one body. The Synology became dragon, since it sits on the hoard. Proxmox&rsquo;s description field on each VM holds the plain role as well, so nobody has to know their folklore to find Plex.</p>
<table>
  <thead>
      <tr>
          <th>VM</th>
          <th>Job</th>
          <th>Why the name</th>
      </tr>
  </thead>
  <tbody>
      <tr>
          <td>argus</td>
          <td>Monitoring and control: Grafana, Loki, VictoriaMetrics, Alertmanager, Uptime Kuma, ntfy, Komodo Core</td>
          <td>The hundred-eyed watchman</td>
      </tr>
      <tr>
          <td>cerberus</td>
          <td>Login only. Pocket ID, and no other app</td>
          <td>Guards the gate</td>
      </tr>
      <tr>
          <td>cyclops</td>
          <td>Plex, with the iGPU and NPU passed through</td>
          <td>The smith at the forge, where the heavy hardware lives</td>
      </tr>
      <tr>
          <td>goblin</td>
          <td>The download apps. No access to anything but the media share</td>
          <td>Grabs loot, and isn&rsquo;t fully trusted</td>
      </tr>
      <tr>
          <td>golem</td>
          <td>Paperless, with the family-facing apps to follow</td>
          <td>Does what it&rsquo;s told</td>
      </tr>
      <tr>
          <td>brownie</td>
          <td>Home Assistant&rsquo;s new home, built empty on the 14th</td>
          <td>The household spirit that does the chores</td>
      </tr>
      <tr>
          <td>djinn</td>
          <td>Where Claude lives</td>
          <td>Bound to serve, and grants requests within the rules</td>
      </tr>
      <tr>
          <td>kobold</td>
          <td>CI, alone on a network that can only reach the internet</td>
          <td>Works down the mines, out of sight of the house</td>
      </tr>
  </tbody>
</table>
<p>There&rsquo;s one more VM that I&rsquo;m leaving out of this series. A public edge VM called sphinx is designed but not built. Like its namesake at the gate, it won&rsquo;t let anyone past who can&rsquo;t answer, and the answer is a client certificate.</p>
<p>Every one of them is a full VM, with no LXC containers anywhere. Proxmox itself <a href="https://pve.proxmox.com/wiki/Linux_Container" target="_blank" rel="noopener">recommends a VM for Docker</a> rather than a container, and keeping to one guest type means one Ansible baseline and one backup method. Each VM runs Ubuntu 26.04 rather than Debian because I wanted the newer kernel and Intel drivers for GPU and NPU passthrough on a chip this new. The app VMs each run their own Caddy for TLS, Grafana Alloy for logs and metrics, cAdvisor, and the Komodo Periphery agent.</p>
<p>cerberus is deliberately the smallest and dullest VM in the house. If it goes down, existing sessions carry on, admin access has a break-glass path, and Home Assistant and Plex don&rsquo;t notice. That only holds while nothing else runs there, so the monitoring lives on argus instead.</p>
<h2 id="how-a-change-reaches-a-server">How a change reaches a server</h2>
<p>The repo is the interface. Everything that runs is described in a private GitHub repo, and the rule written into Claude&rsquo;s instructions is that nothing the repo automates gets done by hand.</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-fallback" data-lang="fallback"><span style="display:flex;"><span>homelab/
</span></span><span style="display:flex;"><span>  ansible/        # VM baseline: users, Docker, agents, reboot slots
</span></span><span style="display:flex;"><span>  proxmox/        # vms.yaml + pve-vm.py, which creates and reconciles VMs
</span></span><span style="display:flex;"><span>  komodo/         # Komodo servers and stacks as TOML
</span></span><span style="display:flex;"><span>  dns/            # records.yaml, synced to the gateway
</span></span><span style="display:flex;"><span>  stacks/&lt;vm&gt;/&lt;stack&gt;/compose.yaml   # plus secrets/*.tpl with op:// refs only
</span></span></code></pre></div><p>A new VM is an entry in <code>vms.yaml</code> and a run of <code>pve-vm.py</code>. A new app is a folder under <code>stacks/</code>, a compose file, and a <code>[[stack]]</code> entry in Komodo&rsquo;s TOML. Secrets are templates holding 1Password <code>op://</code> references, rendered on the server at deploy time, so the repo never contains one.</p>
<p>When a change merges, Komodo&rsquo;s Resource Sync reads the TOML and only the stacks whose folders changed get redeployed. The result goes to ntfy on my phone. Renovate opens a PR for each new image, CI and a Claude review check it, and small updates may merge overnight. That hasn&rsquo;t actually happened yet, and the review gets its own part later, because release notes are text from strangers and it&rsquo;s an LLM reading them.</p>
<h2 id="the-decisions-that-held">The decisions that held</h2>
<p>Every choice in this section was my call, the naming theme included, and I&rsquo;d defend all of them. A few, with what they beat:</p>
<table>
  <thead>
      <tr>
          <th>Chose</th>
          <th>Over</th>
          <th>Because</th>
      </tr>
  </thead>
  <tbody>
      <tr>
          <td>One Komodo stack per app</td>
          <td>One stack per VM</td>
          <td>An update restarts one app, not a whole VM&rsquo;s worth</td>
      </tr>
      <tr>
          <td>Komodo</td>
          <td>Portainer, Dockge</td>
          <td>Git stacks and Resource Sync: rebuilding Komodo is pointing a sync at the repo</td>
      </tr>
      <tr>
          <td>Periphery as a systemd service</td>
          <td>Periphery in a container</td>
          <td>A containerised agent can&rsquo;t redeploy itself mid-job</td>
      </tr>
      <tr>
          <td>GitHub</td>
          <td>Forgejo</td>
          <td>Deploys don&rsquo;t depend on the homelab being up</td>
      </tr>
      <tr>
          <td>NFS for VM mounts</td>
          <td>SMB</td>
          <td>Metadata speed, hardlinks for the download apps, no case-insensitivity surprises</td>
      </tr>
      <tr>
          <td>Home Assistant Container</td>
          <td>HAOS</td>
          <td>Renovate updates it like everything else</td>
      </tr>
      <tr>
          <td>No Swarm</td>
          <td>Docker Swarm</td>
          <td>One physical host, and Pocket ID&rsquo;s SQLite can&rsquo;t run active-active anyway</td>
      </tr>
  </tbody>
</table>
<p>The one that didn&rsquo;t hold was remote access. The plan said WireGuard for everyone, and that lasted until 9 November. An always-on VPN on relatives&rsquo; phones that I don&rsquo;t manage means captive portals break it, my outage becomes their outage, and they get far more reach into the network than a Plex request page needs. Tailscale was rejected over battery drain on iOS, Cloudflare Tunnel over its 100 MB upload limit, and a VPS reverse proxy because it puts the trust anchor on a machine I don&rsquo;t own and costs US$6 a month for little gain. What replaced it is a single edge VM taking client certificates on one port, which is the design for sphinx. The design keeps WireGuard, which isn&rsquo;t built yet, for my admin access and for one app that can&rsquo;t present a certificate.</p>
<h2 id="the-week">The week</h2>
<p>The commits by day give a sense of the pace:</p>
<table>
  <thead>
      <tr>
          <th>Day</th>
          <th>Commits</th>
          <th>What landed</th>
      </tr>
  </thead>
  <tbody>
      <tr>
          <td>Mon 9 Nov</td>
          <td>69</td>
          <td>Repo restructured, first VMs from vms.yaml, monitoring on argus, Pocket ID, Plex and the download apps moved off the NAS</td>
      </tr>
      <tr>
          <td>Tue 10 Nov</td>
          <td>90</td>
          <td>Komodo git stacks, PR validation, deploys from the runner, Renovate</td>
      </tr>
      <tr>
          <td>Wed 11 Nov</td>
          <td>62</td>
          <td>djinn built and Claude given its own accounts, Paperless&rsquo;s VM</td>
      </tr>
      <tr>
          <td>Thu 12 Nov</td>
          <td>98</td>
          <td>NAS audit, nightly VM backups and a tested restore, Paperless live, usage telemetry</td>
      </tr>
      <tr>
          <td>Fri 13 Nov</td>
          <td>141</td>
          <td>The out-of-memory loop, the throttling, CI minutes running out and the isolated runner</td>
      </tr>
      <tr>
          <td>Sat 14 Nov (to 6 pm)</td>
          <td>114</td>
          <td>The backlog as issues, the story launcher, the first story run through it</td>
      </tr>
  </tbody>
</table>
<p>Claude&rsquo;s own GitHub account made 341 of those, 129 of them PR merges. Under my name there are 131 commits with an Assisted-by trailer, mostly from before Claude had an account of its own, plus 61 merges I clicked. Not one non-merge commit is mine alone. Renovate made 32, and the nine from &ldquo;Story worker&rdquo; are the launcher&rsquo;s headless runs, which are the subject of part six.</p>
<p>Early on that took a lot of my time. I was working out how each piece worked, and going through it with Claude to find out whether each thing could be done by hand before anything automated it. Then my part tapered off. By the end of the week I was mostly involved in what a story or task should achieve, and the design and implementation were left to the agents.</p>
<p>It wasn&rsquo;t tidy. On the Friday the monitoring VM got stuck in a loop of out-of-memory kills, because I didn&rsquo;t understand how Proxmox ballooning decides who gives up RAM. The same day GitHub Actions minutes ran out and the CPU started throttling. Those get two parts of their own.</p>
<h2 id="whats-coming">What&rsquo;s coming</h2>
<p>Part two is the working agreement that let Claude do this: its own accounts, full sudo instead of an allowlist, change classes, and the rule that it merges its own PRs. Part three is about guardrails written as prose and what they turned out to catch. After that come the incidents, the CI runner, and the launcher that runs agent workers without trusting a word they write.</p>
<p><em>Assisted by Claude Code (claude-opus-5-5). The experiments, bugs and conclusions are mine. How I work with AI tools is in <a href="/posts/the-ai-pair-programmer/">The AI pair programmer</a>.</em></p>
]]></content:encoded></item></channel></rss>