Files
itpp-docs/docs-source/homelab/index.md
T
Germaine Brown 98073dc636
Publish Docs Site / build (push) Failing after 5s
feat: initial itpp-docs setup with MkDocs Material
- mkdocs.yml with dark slate theme, nav for 12 ITPP projects
- build-docs.sh aggregates docs from all project repos
- .gitea/workflows/docs-publish.yml for nightly rebuild+deploy
- README and CHANGELOG for the itpp-docs repo itself
- docs-source/ populated from all 12 repos
- site/ ready for deployment to docs.itpropartner.com
2026-08-09 23:49:45 -04:00

75 lines
2.7 KiB
Markdown

# homelab
Proxmox, QNAP, and home network management.
**Last updated:** 2026-08-09
## Hosts
| Host | IP | Role | Version |
|---|---|---|---|
| vm-host-01 | 10.1.1.100 | Proxmox — docker-host-01, adguard-home | **PVE 8.4.1** (kernel 6.8.12-10-pve) |
| vm-host-02 | 10.1.1.110 | Proxmox — cleared for GPU | **PVE 8.4.1** (kernel 6.8.12-10-pve) |
| QNAP TS-1635 | 10.1.1.40 | Shared storage, 4 pools | **Firmware 5.2.7** |
| docker-host-01 | 10.1.1.14 | Docker services (13 containers) | VM 105 on vm-host-01 |
| MikroTik router | 10.1.1.1 | Gateway, WireGuard/L2TP endpoint | — |
## Connectivity
| Tunnel | Type | Status | Notes |
|---|---|---|---|
| Core ↔ MikroTik | WireGuard (wg0) | ✅ Up | Core's wg0, port 51821 |
| Core ↔ MikroTik | L2TP | ✅ Up | SSH: `shonuff@192.168.88.1` |
| MikroTik → LAN | Route | ✅ Up | 10.1.0.0/24 reachable from Core |
## SSH Access
- Key: `homelab` (ed25519) at `/root/.ssh/homelab`
- Deployed to: vm-host-01, vm-host-02, QNAP (admin user), docker-host-01
## Storage
| Pool | Size | Used | Mount |
|---|---|---|---|
| CACHEDEV4_DATA | 2.0T | 6% (112.8G) | `/share/CACHEDEV4_DATA` |
| CACHEDEV5_DATA | 14.9T | 31% (4.6T) | `/share/CACHEDEV5_DATA` |
| CACHEDEV6_DATA | 15.9T | 38% (6.1T) | `/share/CACHEDEV6_DATA` |
| CACHEDEV7_DATA | 1.0T | 4% (40.8G) | `/share/CACHEDEV7_DATA`, ISO export |
**NFS exports on Proxmox hosts (as of Aug 9):**
- `qnap-nfs-backups` — 10.1.1.40:/ISO → `/mnt/pve/qnap-nfs-backups` (1TB)
- `qnap-nfs-iso` — 10.1.1.40:/ISO → `/mnt/pve/qnap-nfs-iso` (1TB)
- ⚠️ `qnap-nfs` (VM migration storage) mount point `/mnt/pve/qnap-nfs` does not exist on vm-host-01
## VMs
### vm-host-01 (10.1.1.100)
| VMID | Name | Status | RAM | Disk |
|---|---|---|---|---|
| 100 | adguard-home | **stopped** | 2GB | 32GB |
| 105 | docker-host-01 | running | 16GB | 150GB |
### vm-host-02 (10.1.1.110)
**CLEARED** — no VMs. Ready for GPU installation.
## DNS
- **Primary AdGuard Home:** docker-host-01 at `10.1.1.14`
- **Admin UI:** `http://10.1.1.14:8080/login.html`
- DNS service: port `53`
- **Secondary:** app2 Technitium (`dns1.itpropartner.com`)
- **Tertiary:** vm-host-01 AdGuard (`10.1.1.10`) — **VM stopped**, secondary DNS unavailable
> Do not use `http://10.1.1.14:80` for AdGuard administration; that port serves NGINX Proxy Manager.
## Services on docker-host-01
- Mealie (:9925), n8n (:5678), Home Assistant (:8123)
- Jellyfin (:8096), Prowlarr/Radarr/Sonarr/Sabnzbd (media pipeline)
- AdGuard Home DNS (:53) + admin UI (:8080)
- NPM (:80/:443), Uptime Kuma (:3001)
- Dockhand (:3100), Browser-Use WebUI (:6080/:7788)
- 13 containers total, ~3.8GB RAM of 16GB allocated
## Key Docs
- `state-2026-08-09.md` — current state snapshot
- `state-2026-07-21.md` — previous state (pre-August audit)