XTRM-Unraid
de42738775
All checks were successful
ci/woodpecker/push/woodpecker Pipeline was successful
New WIP documents: - FOSSORIAL-TUNNELS.md - Pangolin/Gerbil self-hosted tunnels (not deployed) - VLAN-SEGMENTATION.md - Network segmentation plan (not implemented) - REMOTE-GAMING.md - Sunshine/Moonlight streaming (in progress) Changes: - Renamed 05-CHANGELOG.md → 00-CHANGELOG.md - Updated wip/README.md with all planned items Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
84 lines
2.0 KiB
Markdown
84 lines
2.0 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
|
|
├── 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
|
|
|
|
```bash
|
|
# 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.
|