painfully·useful

Field Notes

4leafclover

4leafclover

4leafclover A Ghost theme I built because I needed one and didn't want to pay for a premium option. Dark, high-contrast, opinionated. Not a polished commercial release, but it runs in production on this site, which is the only proof of concept that matters. Free. Grab it, fork

Apr 10, 2026 1 min read
How Much to Write Before Claude Builds It

How Much to Write Before Claude Builds It

N.O.R.A is a self-hosted homelab monitoring platform built with Claude Code as the primary executor. The workflow is settled: design sessions produce specifications, specifications become GitHub issues via PowerShell scripts, Claude Code builds against them. The question this post is about is not whether to use this

Apr 7, 2026 6 min read
Deploying Diun and Watchtower: The Decisions That Determine Whether It Actually Works

Deploying Diun and Watchtower: The Decisions That Determine Whether It Actually Works

Starting point The decision to use Diun alongside Watchtower has already been made: Diun handles notification, Watchtower handles execution, and the combination restores a human checkpoint to a change surface that running :latest tags makes otherwise invisible. What that setup actually looks like, and whether it holds under real operating

Mar 17, 2026 7 min read
Container Update Workflows: Decoupling Awareness from Action

Container Update Workflows: Decoupling Awareness from Action

The default is dangerous, but not for the reason you think Most containers in most homelabs run on :latest tags. The reasons are familiar: introductory Docker content defaults to it, most Compose examples don't specify versions, and pinning feels like extra work for uncertain benefit. The result is

Mar 17, 2026 5 min read
The Recovery Runbook You Should Have Written Six Months Ago

The Recovery Runbook You Should Have Written Six Months Ago

Halfway through writing the recovery procedure for a stack you've been running for two years, you realize you don't know where the .env file actually lives, whether the named volume is app_data or app-data, or what network_mode: host is doing on that one service

Mar 14, 2026 7 min read
How Deep Does the Recovery Documentation Need to Go?

How Deep Does the Recovery Documentation Need to Go?

The Architecture post for this idea draws the line between data resilience and operational resilience , between the backup job completing and actually being able to rebuild your environment. That line is the reason you're here. The decision this post is about is what comes next: given that the

Mar 14, 2026 7 min read
The 3-2-1 Rule Covers Data. It Doesn't Cover Knowledge.

The 3-2-1 Rule Covers Data. It Doesn't Cover Knowledge.

The 3-2-1 backup rule is useful because it's specific. Three copies of your data. Two different storage media. One offsite. That specificity is what made it spread — it's a checklist, not a philosophy. You can implement it, verify it, and cross it off. The backup job

Mar 14, 2026 5 min read
Building the Home Assistant Docker Stack: MariaDB, Z-Wave JS UI, and the One USB Path That Survives a Reboot

Building the Home Assistant Docker Stack: MariaDB, Z-Wave JS UI, and the One USB Path That Survives a Reboot

The Z-Wave USB stick is invisible inside the container. Every setup guide tells you to add a devices: entry to your compose file and pass the path /dev/ttyUSB0. On first boot it works. After a reboot, the path has rotated to /dev/ttyACM0, or shifted to /dev/ttyUSB1 because

Mar 12, 2026 5 min read
Getting Home Assistant Off Your Local Network: Remote Access Decisions That Actually Matter

Getting Home Assistant Off Your Local Network: Remote Access Decisions That Actually Matter

The Docker stack is running. Z-Wave devices are responding. MariaDB is handling the recorder. The local experience is solid. Then someone asks whether they can control the lights from their phone when they're away from home, and the comfortable self-contained feeling of the stack immediately collides with the

Mar 12, 2026 6 min read
When Home Automation Becomes Infrastructure

When Home Automation Becomes Infrastructure

There's a moment in most home automation projects when the framing shifts. It doesn't announce itself. One day you're automating a light, the next you're thinking about database backend selection, container isolation boundaries, and whether your remote access method is actually secure

Mar 12, 2026 5 min read