Skip to main content

Tutorials

Step-by-Step Guides

Step-by-step guides you can follow in your own homelab. Each tutorial is tested, documented, and includes verification steps.

What Every Tutorial Includes
#

SectionPurpose
PrerequisitesWhat you need before starting
Step-by-step instructionsNumbered steps with commands and explanations
VerificationHow to confirm it worked
TroubleshootingCommon issues and fixes
What I LearnedGotchas and lessons from my experience

Difficulty Levels
#

LevelWhat It Means
🟢 BeginnerCopy-paste friendly. Minimal prior knowledge.
🟡 IntermediateAssumes Linux CLI comfort and basic networking.
🔴 AdvancedComplex multi-service setups. Troubleshooting required.

Browse by Topic
#

  • Security: Cloudflare, Vaultwarden, access control
  • Networking: DNS, reverse proxy, VLANs
  • Automation: n8n, Ansible, CI/CD
  • Monitoring: Graylog, Uptime Kuma, alerting

Available Tutorials
#

2026

High-Availability Pi-hole DNS with Keepalived VRRP

Overview # DNS is the backbone of your network. When your Pi-hole goes down, every device in your home loses internet access. Websites won’t load. Apps stop working. Smart home devices go offline. It’s a single point of failure that brings everything to a halt. This tutorial shows you how to build a resilient DNS infrastructure using two Pi-hole servers with automatic failover. If one server dies, the other seamlessly takes over in under 15 seconds — without any manual intervention.

Protecting Vaultwarden Behind Caddy with Cloudflare Proxy

Overview # Your password vault is arguably the most sensitive service in your homelab. Exposing Vaultwarden to the internet requires layered protection. This tutorial shows how to add Cloudflare Proxy (WAF, DDoS protection, bot management) in front of Vaultwarden while preserving real client IP logging. What you’ll achieve: 1 2 3 4 5 6 7 8 9 Client (real IP) ↓ Cloudflare Edge (WAF, DDoS, Bot protection) ↓ CF-Connecting-IP header Your Firewall (geo-blocking, threat intel) ↓ Caddy (extracts real IP, TLS termination) ↓ X-Real-IP header Vaultwarden (rate limiting, 2FA, logs real IP) Prerequisites # Vaultwarden already running behind Caddy reverse proxy Domain managed by Cloudflare (DNS) Caddy with valid TLS certificates (Let’s Encrypt/ACME) Basic understanding of reverse proxies The Problem # When you enable Cloudflare Proxy (orange cloud), traffic flows through Cloudflare’s edge servers before reaching your origin. This provides excellent protection, but introduces two challenges: