Kaloyan Danchev e9572ae166 Add VLAN setup documentation - complete implementation
- docs/12-VLAN-SETUP-PROGRESS.md: Progress tracking during setup
- docs/13-VLAN-SETUP-PLAN-V2.md: Initial VLAN plan
- docs/14-VLAN-SETUP-PLAN-V3-SAFE-MODE.md: Safe mode approach
- docs/15-VLAN-SETUP-COMPLETE-2026-01-31.md: Final session summary

VLANs implemented:
- VLAN 10: Management (192.168.10.0/24) - port-based
- VLAN 20: Trusted (192.168.20.0/24) - WiFi MAC-based
- VLAN 25: Kids (192.168.25.0/24) - WiFi MAC-based
- VLAN 30: IoT (192.168.30.0/24) - WiFi MAC-based
- VLAN 40: Catch-All (192.168.1.0/24) - default

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-31 13:05:33 +02:00
2026-01-18 16:40:48 +02:00

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.

Description
No description provided
Readme 959 KiB
Languages
RouterOS Script 81.6%
Shell 18.4%