Homelab Documentation

This repository documents my homelab architecture, services, troubleshooting, deployments, and operational notes. The lab is focused on practical networking, self-hosting, Linux administration, reliability, and public-facing documentation of real infrastructure work.

Topology

Environment Summary

Current environment includes:

• OPNsense router/firewall
• Main server: seranogenomics
• NAS: nas
• LAN: 192.168.5.0/24
• OpenVPN subnet: 192.168.6.0/24
• 2.5 Gbps internet service
• 2.5 GbE switching on the core wired path
• Wi-Fi provided by the ISP modem/router
• AdGuard Home + Unbound for DNS
• Docker/YAMS media stack
• UPS/NUT shutdown and recovery work
• additional standalone self-hosted services such as:
  • reading stack (Komga, Suwayomi, Calibre-Web)
  • Karakeep
  • Tailscale
  • Home Assistant

Goals

• build practical NetOps, sysadmin, and self-hosting skills
• improve reliability and recovery workflows
• document troubleshooting and design decisions clearly
• maintain a public portfolio of real homelab work

Core Documentation

• Core Documentation

Operations Documentation

• Operations Documentation

Incident and Recovery Writeups

• Incidents and Fixes

Service Deployment Writeups

• Service Deployments

Current Focus

• improving SG preboot/dropbear remote unlock reliability
• continuing NAS power-loss / boot behavior investigation
• keeping VPN behavior clearly documented
• improving long-term maintainability and recovery documentation

Why This Repo Exists

This repo serves two purposes:

1. personal infrastructure documentation for operating and maintaining the lab
2. a public showcase of practical networking, Linux administration, self-hosting, and troubleshooting work

Notes

All public documentation is sanitized. Sensitive information such as credentials, private keys, tokens, and other secrets is excluded from this repository.