XTRM Home Lab Infrastructure

Domain: xtrm-lab.org
Repository: https://git.xtrm-lab.org/jazzymc/infrastructure

---

Quick Reference

Resource	Address
Dashboard	https://xtrm-lab.org
NetBox	https://netbox.xtrm-lab.org
Git	https://git.xtrm-lab.org
CI/CD	https://ci.xtrm-lab.org
DNS Primary	dns.xtrm-lab.org
DNS Secondary	dns2.xtrm-lab.org

---

Documentation Structure

docs/
├── 01-NETWORK-MAP.md        # Network topology, IPs, Docker networks
├── 02-SERVICES-CRITICAL.md  # DNS, Auth, Routing - must stay up
├── 03-SERVICES-OTHER.md     # All other services
├── 04-HARDWARE-INVENTORY.md # Physical devices, specs, serials
├── 00-CHANGELOG.md          # Major events only
├── wip/                     # Planned changes & ideas
│   ├── UPGRADE-2026-HARDWARE.md
│   └── GITOPS-CONTAINERS.md
└── archive/                 # Legacy docs (read-only)

---

Key Devices

Device	IP	Role
HAP1	192.168.31.1	Router, DNS, WiFi Controller
XTRM-U	192.168.31.2	Production Server (Unraid)
CSS1	192.168.31.9	Distribution Switch
ZX1	192.168.31.7	Core Switch (2.5G)
CAP	192.168.31.6	Wireless Access Point

---

SSH Access

# Unraid
ssh -i ~/.ssh/id_ed25519_unraid root@192.168.31.2 -p 422

# MikroTik Router
ssh -i ~/.ssh/mikrotik_key -p 2222 unraid@192.168.31.1

---

Emergency Recovery

1. DNS down? → Clients fallback to 192.168.31.4 (secondary)
2. Internet down? → Check HAP1 at 192.168.31.1
3. Services down? → Check Unraid at 192.168.31.2
4. Full outage? → See 02-SERVICES-CRITICAL.md startup order

---

Change Management

• Major changes: Document in 00-CHANGELOG.md
• Minor changes: Git commit messages only
• Planned work: Create doc in wip/ folder

---

CI/CD

Woodpecker CI at https://ci.xtrm-lab.org

Pipelines trigger on push to this repository.