About This TrueNAS Home Server Build

About This Build

A Smart Home Server Built From Scratch, Documented As It Happened

Every post here reflects how it actually happened — built, broken, debugged, and rebuilt.

The TrueNAS Home Server Project

This blog documents a self-hosted TrueNAS home server, built on the free Community Edition. It started as a fully automated media server running in Docker, and grew into the hub of the house with Home Assistant running on top. Everything covered here was built, broken, debugged, and rebuilt — the posts reflect how it actually happened, not a polished tutorial written after the fact.

The TrueNAS home server: a Jonsbo case with its front open and hard drives in the numbered bays

The goal was a fully automated pipeline: request a movie or TV show, and it appears in Plex without any manual steps. Along the way that meant solving real problems — VPN kill switches, Cloudflare tunnel quirks, iptables race conditions, and config files that overwrite themselves on shutdown.

Why Write It Down

Most home server write-ups skip the parts that actually cost time — the silent permission failure, the container that “works” until a reboot, the config that only breaks under load. This is a record of those parts too, written close to when they happened so the debugging steps are still accurate.

If you’re building something similar, the guides are the running log, and the buttons at the bottom of this page are the best place to start. My home server build covers where it started and what I’ve upgraded since.

🏠 Then Came Home Automation

Once the server was running every day, it made sense to put the rest of the house on it too. Home Assistant now runs alongside the media stack and ties everything together: the TVs, the washer and dryer, the car, the energy meter, and wall-mounted iPads that show the whole house at a glance.

Most of the dashboard is custom cards built for this house, and the guides show how each one works so you can build your own:

The cards are free on GitHub, and there are short videos of them on YouTube (@mymediabuild).

The Stack

What’s actually running under the hood

🗄️

Storage

TrueNAS Community Edition, ZFS pool, NFSv4 ACLs on every app dataset.

📦

Containers

Everything runs in Docker, each app defined in its own Docker Compose file.

🔒

VPN

ProtonVPN via Gluetun, with a full kill switch on the download clients.

📡

External Access

Cloudflare Tunnel + Traefik. No ports forwarded on the router.

🔐

SSO + 2FA

Authentik with mandatory TOTP across every service, one login, one session.

🎬

Media Automation

Radarr, Sonarr, Prowlarr, SABnzbd, qBittorrent, Plex and Cantinarr: request to playback, no manual steps.

🏠

Home Assistant

Home Assistant in Docker, with MQTT for sensors and the hOn integration for the washer and dryer.

📱

Wall Dashboards

Wall-mounted iPads running custom cards: a live 3D floor plan, laundry, car and more.

⚡

Energy

Live smart meter readings in Home Assistant’s Energy dashboard.

Start Here