All guides

Every guide on the site, in reading order. New guides are added as their own pages so each topic can be found, shared and updated on its own.

Home Assistant: the complete build

The flagship 12-part guide — start to finish, Docker on a NAS, all radios, cameras, voice, switches, sensors and networking.

Getting started with Home Assistant in Docker

Install Home Assistant on a NAS, add the Matter server, and avoid the two mistakes that trip up almost everyone.

Radios & protocols explained

Zigbee vs Z-Wave vs Thread vs Bluetooth — what each radio does, what it costs, and which ones you can skip.

Cameras with local recording and no subscription

Reolink cameras and doorbells, SD-card vs NAS recording, and the real storage maths for 24/7 video.

Voice & music without the cloud

Replace Alexa with self-hosted Assist satellites, Whisper/Piper speech pipelines, and Music Assistant for whole-home audio.

Smart switches & sensors

Four routes to smart lighting from $17.90 a point, plus the sensors that make a house feel smart: presence, leak, air quality and energy.

Network, AdGuard & remote access

AdGuard Home on your NAS, the IPv6 leak that silently bypasses it, and Tailscale remote access done in the safe order.

Build list & costs

Every recommended item, priced, in three tiers: $632.93 to start, roughly $1,600–$1,800 for the full build.

Home Assistant guides

HACS to Marketplace migration

2026.11 folded HACS into the built-in Marketplace — what migrated, what silently stops updating, and the post-upgrade checklist.

Entity naming after 2026.11

The naming rework changed how names are built — what looks different, what renamed, and the one-pass fix for dashboards and voice.

TrueNAS app to HAOS migration

The TrueNAS HA app was removed Nov 26, 2026 — move to HAOS in a VM with your full backup, devices and history intact.

Frigate 0.18 + GenAI

UI configuration, camera profiles, semantic search — and the new hardware truth about the Coral. Upgrade safely.

Local LLM voice: Ollama + Qwen3

Beyond Whisper/Piper: a local LLM as the conversation agent. Model picks by VRAM, tool calling, exposed-entity discipline.

Matter 1.5 cameras in HA

The first Matter cameras are here: what works in 2026.11, the talkback caveat, and when Frigate is still the answer.

Zigbee coordinator migration 2026

ZBT-2, Sonoff MG24, PoE options and the ember driver — migrate without re-pairing your house.

Native IR/RF control

HA 2026 made IR/RF first-class: learn a remote once and the ceiling fan, fireplace and dumb TV join the system.

Robot vacuums, locally

Matter area cleaning (2026.3), Valetudo liberation, and the honest tiers of local vacuum control.

Whole-home energy hardware

Emporia Vue vs Shelly Pro 3EM vs IoTaWatt: circuit-level truth for your energy dashboard, plus the CT math.

LoRaWAN in Home Assistant

Native in 2026.11: sensors kilometers away on coin cells. Gateways, ChirpStack vs TTN, and the far-property use cases.

Zigbee Green Power switches

Batteryless kinetic switches — powered by the click, mounted anywhere. New in HA 2026.11, with honest limits.

Black Friday 2026: buy, wait, skip

Small gear barely discounts; big gear swings $100+. The honest buy/wait/skip list for Nov 19–30.

Home Assistant backups: the 3-2-1 strategy

Backups that actually restore: local copies, off-site copies, encryption keys, and the restore drill most people skip.

Building a dashboard people actually use

Tablet and phone layouts, room-first design, and the cards worth putting on a wall dashboard.

Automations explained: triggers, conditions, actions

How automations really fire, with worked YAML examples you can paste in and adapt.

Presence detection that works

Person tracking without false alarms: phone, router, Bluetooth and Bayesian layers combined.

Fixing a flaky Zigbee network

Channels, Wi-Fi interference and router placement — the methodical way to stop dropouts.

Zigbee2MQTT vs ZHA

The honest comparison: device support, setup effort, the Docker angle, and the re-pairing cost of switching later.

Matter over Thread, end to end

Border routers, the Matter Server in Docker, phone commissioning — and the IPv6 gotcha that breaks pairing.

ESPHome for beginners: your first three devices

Build a temperature sensor, a smart plug and a Bluetooth proxy from cheap ESP32 boards.

Frigate NVR with Home Assistant

Local AI person and object detection for your cameras, with zones, masks and notifications.

Frigate with a Coral TPU in Docker

USB passthrough, the detector config, and how to prove the Coral — not your CPU — is doing the detecting.

Frigate zones & masks

Detect everywhere, alert where it matters: motion masks, zones and required-zone rules that end false alerts.

Local voice: Whisper + Piper in Docker

Home Assistant's voice pipeline with zero cloud: Wyoming containers for wake word, speech-to-text and speech.

Music Assistant for beginners

One library across streaming and files, played on every speaker you own — the local-first music server.

Setting up the energy dashboard

Grid, solar and individual devices in Home Assistant's energy view — including the watts-to-kWh fix.

Smart locks and garage doors, safely

Local control for locks and ratgdo-style garage openers, with the safety checks that matter.

Z-Wave JS UI in Docker

The standalone Z-Wave control panel: stick passthrough, the keys you must back up, and the WebSocket link to Home Assistant.

Actionable notifications

Alerts that reach you — and let you act from the notification itself, with priority tiers.

Under-cabinet kitchen lighting

LED strips, Zigbee controllers and the honest power options, wired safely with Home Assistant.

Adaptive Lighting: circadian light, automated

Lights that follow the sun — bright and cool by day, warm and dim by night — and politely stop when you take over.

Self-hosting guides

Plex to Jellyfin migration

Lifetime hit $749.99 and remote streaming got paywalled. The full move: library, watch-state sync, users and free remote access.

Jellyfin 12 upgrade guide

Version 12 replaced the database — no downgrade without a backup. Pre-flight, plugin audit and transcoding verification.

Seerr setup (the merged Overseerr)

Overseerr + Jellyseerr became Seerr. Set it up with the single-/data hardlink layout so requests flow to your library instantly.

Stirling-PDF on a NAS

60+ private PDF tools — merge, OCR, redact, sign — in one container. r/selfhosted's #2 app, paired with Paperless.

Pangolin: self-hosted tunnel

Cloudflare-Tunnel-style publishing from your own VPS: Newt agent at home, Traefik on the edge, SSO at the door.

Authentik vs Authelia SSO

One login for the whole stack. The full identity platform vs the lightweight gate — pick by weight class.

Restic/Kopia 3-2-1 backups

Encrypted, deduplicated, off-site — and proven with a restore test. The backup strategy your Docker stack deserves.

Immich v3: Workflows & JPEG XL

Immich grows an automation engine, and JPEG XL shrinks your library. What to enable, what to skip, the upgrade path.

Navidrome music server

Your music files as a private streaming service — Subsonic apps everywhere, smart playlists, and the Music Assistant pairing.

Actual Budget (self-hosted)

YNAB-style envelope budgeting on your NAS: local-first, encrypted sync, bank import. The January setup that lasts.

Karakeep bookmarks

The bookmark hoard that archives pages, extracts readable text and tags itself with AI — local models welcome.

Self-hosting on a NAS with Docker

The beginner's mental model — images, containers, volumes — and your first five containers.

Remote access compared: Tailscale, Cloudflare Tunnel, reverse proxy

Three safe ways in from outside, who each one is really for, and what to avoid.

AdGuard Home vs Pi-hole

Which DNS filter to run, how they differ in daily use, and how to run either on a NAS.

Vaultwarden: your own password manager

Self-host Bitwarden's lightweight server, secure it properly, and move your vault over.

Immich: self-hosted Google Photos replacement

Your photo library on your NAS, with face recognition, maps and phone backup — no subscription.

Immich hardware acceleration

Quick Sync transcoding plus GPU machine learning, via Immich's own Compose overrides — and how to verify both.

Jellyfin on a NAS

Your own media server with hardware transcoding, libraries done right, and apps for every screen.

Jellyfin hardware transcoding (Quick Sync)

Put your Intel iGPU to work: /dev/dri passthrough, the render-group gotcha, QSV settings and verification.

Paperless-ngx: every document, findable

Scan, OCR and search your paperwork with a consume folder that files things for you.

Uptime Kuma: know when things break

Monitor every self-hosted service and get alerted before anyone else notices.

A homepage for your homelab

Homarr, Heimdall and the one-address dashboard that ties your services together.

NAS Docker Essentials

Beszel monitoring

Lightweight monitoring for every machine: hub + tiny agents, history, container stats and alerts that matter.

Dockge vs Portainer

Compose files as files — no database, no lock-in. The honest comparison and the zero-risk side-by-side trial.

Homepage vs Homarr vs Glance

The start-page decision: widget density vs drag-and-drop polish vs glanceable minimalism. Pick without installing all three.

Docker Compose basics on a NAS

Stacks, volumes and networks explained — the one skill every container uses.

Portainer: Docker without the terminal

Manage containers, stacks and updates from a clean web UI.

Nginx Proxy Manager

Friendly names and free HTTPS for your home services.

Watchtower & safe container updates

Which containers may update themselves — and which never should.

Nextcloud on a NAS

Your own cloud drive with sync clients and proper backups.

Plex Media Server on a NAS

Your movies and shows, with hardware transcoding.

The *arr stack, explained

Sonarr, Radarr, Prowlarr and qBittorrent organizing media you own.

Gluetun: VPN for Docker containers

Route selected containers through your VPN with an architectural kill switch — and prove it with leak tests.

Duplicati: encrypted container backups

Scheduled, encrypted backups of the data your containers hold.

Syncthing: cloud-free folder sync

Keep folders in sync between your devices and NAS, no cloud in the middle.

Audiobookshelf

Audiobooks and podcasts with progress that follows you.

Mealie recipe manager

Recipes, meal plans and shopping lists for the household.

Dozzle + Scrutiny

Container logs in a browser and hard-drive health on one dashboard.