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
parent 08ba2e62a8
commit 98073dc636
134 changed files with 55534 additions and 2 deletions
@@ -0,0 +1,18 @@
+# Home Lab Changelog
+
+## 2026-07
+
+### Added
+- **Documentation repo initialized** — Git-tracked home lab infrastructure docs
+- **Host inventory:** vm-host-01 (10.1.1.100), vm-host-02 (10.1.1.110), QNAP TS-1635 (10.1.1.40), docker-host-01 (10.1.1.14), MikroTik router (10.1.1.1)
+- **SSH key:** homelab ed25519 key pair created and deployed to all hosts
+- **QNAP NFS storage:** 3 exports configured — VM migration (2TB), backups (1TB), ISOs (1TB)
+- **DNS chain documented:** AdGuard Home primary (docker-host-01, 10.1.1.14:53), Technitium secondary (dns1.itpropartner.com), AdGuard tertiary (vm-host-01)
+
+### Changed
+- **vm-host-02 cleared** — all VMs migrated to vm-host-01 or destroyed; host ready for GPU installation
+- **VM consolidation:** destroyed template VM, Graylog, Zabbix, and FOG VMs for later rebuild
+
+### Added
+- **State snapshot** (`state-2026-07-21.md`) — VM inventory, service listing, and migration state captured
+- Docker-host-01 service catalog: 13 containers including Mealie, n8n, Home Assistant, Jellyfin, media pipeline (Prowlarr/Radarr/Sonarr/Sabnzbd), AdGuard Home, NPM, Uptime Kuma, Dockhand, Browser-Use WebUI
@@ -0,0 +1,75 @@
+# 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)