ec9659d0cb
All checks were successful
ci/woodpecker/push/woodpecker Pipeline was successful
Major documentation cleanup after VLAN migration completion: - Archive 12 VLAN project docs to archive/vlan-migration/ - Archive 5 done WIP docs (VLAN proposals, AI stack, Fossorial, DNS backup) - Create standing reference docs 08-DNS-ARCHITECTURE and 09-TAILSCALE-VPN - Renumber docs to clean 01-09 sequence with merged CHANGELOG - Update all active docs from stale 192.168.31.x to current VLAN 10 IPs - Fix CSS1 (.10.9→.10.3) and ZX1 (.10.7→.10.4) IPs in hardware inventory - Clean 06-VLAN-DEVICE-ASSIGNMENT: remove migration columns/sections, fix VLAN 25 subnet Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
89 lines
2.4 KiB
Markdown
89 lines
2.4 KiB
Markdown
# 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
|
|
├── 05-PORT-UTILIZATION.md # Device port assignments
|
|
├── 06-VLAN-DEVICE-ASSIGNMENT.md # VLAN device mapping
|
|
├── 07-WIFI-CAPSMAN-CONFIG.md # WiFi and CAPsMAN settings
|
|
├── 08-DNS-ARCHITECTURE.md # DNS failover architecture
|
|
├── 09-TAILSCALE-VPN.md # Tailscale VPN setup
|
|
├── CHANGELOG.md # Change history
|
|
├── archive/ # Completed/legacy docs
|
|
│ └── vlan-migration/ # VLAN migration project artifacts
|
|
├── incidents/ # Incident reports
|
|
└── wip/ # Work in progress
|
|
```
|
|
|
|
---
|
|
|
|
## Key Devices
|
|
|
|
| Device | IP | Role |
|
|
|--------|-----|------|
|
|
| HAP1 | 192.168.10.1 | Router, DNS, WiFi Controller |
|
|
| XTRM-U | 192.168.10.20 | Production Server (Unraid) |
|
|
| CSS1 | 192.168.10.3 | Distribution Switch |
|
|
| ZX1 | 192.168.10.4 | Core Switch (2.5G) |
|
|
| CAP | 192.168.10.6 | Wireless Access Point |
|
|
|
|
---
|
|
|
|
## SSH Access
|
|
|
|
```bash
|
|
# Unraid
|
|
ssh -i ~/.ssh/id_ed25519_unraid root@192.168.10.20 -p 422
|
|
|
|
# MikroTik Router
|
|
ssh -i ~/.ssh/mikrotik_key -p 2222 xtrm@192.168.10.1
|
|
```
|
|
|
|
---
|
|
|
|
## Emergency Recovery
|
|
|
|
1. **DNS down?** → Automatic failover to 192.168.10.10 (secondary), see `08-DNS-ARCHITECTURE.md`
|
|
2. **Internet down?** → Check HAP1 at 192.168.10.1
|
|
3. **Services down?** → Check Unraid at 192.168.10.20
|
|
4. **Full outage?** → See `02-SERVICES-CRITICAL.md` startup order
|
|
|
|
---
|
|
|
|
## Change Management
|
|
|
|
- **Major changes:** Document in `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.
|