148 lines
6.6 KiB
Markdown
148 lines
6.6 KiB
Markdown
# 00 — Master Index
|
|
> Last updated: 2026-06-11
|
|
> Quick-reference card for Claude. Read this first, then load specific files only as needed.
|
|
|
|
---
|
|
|
|
## 🏠 Infrastructure Constants
|
|
|
|
| Key | Value |
|
|
|---|---|
|
|
| **Proxmox host** | `192.168.1.48:8006` |
|
|
| **Gateway** | `192.168.1.1` |
|
|
| **Public IP** | `178.41.205.8` (dynamic — managed by CT 108) |
|
|
| **NAS** | `192.168.1.12` (Synology) |
|
|
| **Domain** | `spendlik.sk` |
|
|
| **Gitea owner** | `spendlik` |
|
|
| **MCP server** | `mcp.spendlik.sk` (CT 112) |
|
|
| **Proxmox kernel** | `6.14.11-5-pve` (6.17.x breaks NVIDIA 550 DKMS) |
|
|
|
|
---
|
|
|
|
## 🖥️ Container & VM Inventory
|
|
|
|
| ID | Hostname | IP | Domain | Purpose |
|
|
|---|---|---|---|---|
|
|
| 100 | n8n | 192.168.1.29 | automation.spendlik.sk | Workflow automation (Authelia protected) |
|
|
| 101 | reverse-proxy | 192.168.1.10 | — | nginx reverse proxy for all services |
|
|
| 102 | authelia | 192.168.1.50 | auth.spendlik.sk | SSO / 2FA gateway |
|
|
| 103 | matrix-synapse | 192.168.1.60 | matrix.spendlik.sk | Self-hosted messaging |
|
|
| 104 | snappymail | 192.168.1.55 | email.spendlik.sk | Webmail (Authelia protected) |
|
|
| 105 | audiobookshelf | 192.168.1.70 | books.spendlik.sk | Ebooks / audiobooks (NAS bind mount) |
|
|
| 106 | jellyfin | 192.168.1.75 | jellyfin.spendlik.sk | Media server (NAS NFS mount) |
|
|
| 107 | wireguard | 192.168.1.80 | — | VPN (UDP 51820) |
|
|
| 108 | ddns | 192.168.1.95 | — | DDNS updater (WebSupport API v2) |
|
|
| 109 | gitea | 192.168.1.90 | git.spendlik.sk | Self-hosted Git |
|
|
| 110 | windows11 (VM) | 192.168.1.227 | — | RTX 4060 passthrough, Rhino 7 + Sunshine |
|
|
| 111 | paperless | 192.168.1.111 | paperless.spendlik.sk | Document management (6-lang OCR, media on NAS) |
|
|
| 112 | mcp-server | 192.168.1.100 | mcp.spendlik.sk | MCP bridge — Proxmox + Gitea tools for Claude |
|
|
| 114 | *(unassigned)* | — | — | Planned: Vaultwarden or BAMbuddy |
|
|
|
|
> Next available CT ID: **114** · Next available IP: **192.168.1.1xx** (check before assigning)
|
|
> CT 113 was removed (AppFlowy → replaced by Obsidian)
|
|
|
|
---
|
|
|
|
## 💻 Devices
|
|
|
|
| Device | OS | Key Detail |
|
|
|---|---|---|
|
|
| Main PC | CachyOS (Arch), KDE Plasma 6 / Wayland | i7-13700K, RTX 4060 Ti, 32GB DDR5 |
|
|
| Galaxy S25 | Android | WireGuard VPN client; MGit for Obsidian sync |
|
|
| Galaxy Tab S9 | Android | MGit for Obsidian sync |
|
|
| Bambu A1 + AMS Lite | — | LAN Only Mode, OrcaSlicer |
|
|
|
|
---
|
|
|
|
## 📁 Documentation Map
|
|
|
|
| File | Covers |
|
|
|---|---|
|
|
| `homelab-overview.md` | Hardware specs, full container/VM table, NAS mounts, network diagram |
|
|
| `cachy-overview.md` | CachyOS main PC — hardware, software, kernel, services, keyboard customisation |
|
|
| `01_hardware_and_software.md` | Proxmox server hardware |
|
|
| `02_linux_containers_and_virtual_machines.md` | Container configs, resources, notes |
|
|
| `03_network_setup.md` | DNS records, WebSupport IDs, DDNS, port forwarding |
|
|
| `04_audiobookshelf_deployment.md` | CT 105 — full deploy guide, NAS mount, troubleshooting |
|
|
| `05_jellyfin_deployment.md` | CT 106 — full deploy guide, NFS, transcoding notes |
|
|
| `06_wireguard_deployment.md` | CT 107 — VPN config, client setup, keys |
|
|
| `09_gpu_setup.md` | RTX 4060 passthrough, VFIO, kernel 6.14 pin, Sunshine |
|
|
| `10_ddns_deployment.md` | CT 108 — WebSupport API v2, HMAC-SHA1 auth, record IDs |
|
|
| `11_gitea_deployment.md` | CT 109 — Gitea binary install, nginx, SSL |
|
|
| `homelab-goals.md` | Roadmap and long-term infrastructure goals |
|
|
|
|
> 💡 Load only the file(s) relevant to the current task. Do not load all files by default.
|
|
|
|
---
|
|
|
|
## 🔑 Key Gotchas (load before touching these areas)
|
|
|
|
| Area | Warning |
|
|
|---|---|
|
|
| **nginx / certbot** | Certbot corrupts configs — always inspect after cert issuance; check for duplicate `server_name` and missing closing braces |
|
|
| **NFS mounts** | Use `soft,timeo=30,retrans=3` — hard NFS can freeze Proxmox host |
|
|
| **DDNS script** | `/tmp/ddns_last_ip` cache; reboot clears it fine — but stale cache can miss IP change |
|
|
| **WebSupport DNS** | Two separate management pages — missing the second caused an outage; update both |
|
|
| **Gitea writes** | Always read file content before writing — writes replace entire file |
|
|
| **Proxmox kernel** | Stay on `6.14.11-5-pve` — 6.17.x breaks NVIDIA 550 DKMS |
|
|
| **OpenRGB** | Uninstalled — SMBus interaction with ADATA XPG GAMMIX D35 poses hardware risk |
|
|
| **Hairpin NAT** | Slovak Telekom router blocks hairpin — test external domains from mobile data, not LAN |
|
|
| **WebSupport API** | Uses numeric service ID `15056760`, not domain name; HMAC-SHA1 signed requests |
|
|
|
|
---
|
|
|
|
## 🔄 Active Projects (as of 2026-06-11)
|
|
|
|
| Project | Next Action | Reference |
|
|
|---|---|---|
|
|
| Paperless-ngx | Migrate media dir to NAS ✅ done; next: Gemini post-processing | CT 111 |
|
|
| Gemini post-processing | Get Gemini API key → install Python package in CT 111 | CT 111 |
|
|
| kocka-novinky.sk automation | Set up Brickset API credentials in n8n | CT 100 |
|
|
| WireGuard DDNS | Add `vpn.spendlik.sk` DNS record + update CT 108 script | CT 107/108 |
|
|
| Vaultwarden | Decide CT ID and IP → deploy Docker LXC | CT 114 (planned) |
|
|
| Bookmark manager | Decide tool (Linkding / Hoarder / Shiori) → deploy | CT 114 (planned) |
|
|
| BAMbuddy | Check Bambu A1 Developer Mode → deploy | CT 114 (planned) |
|
|
| Authelia enforcement | Extend 2FA to Jellyfin, Audiobookshelf, Gitea | CT 102/101 |
|
|
| Spendlikpapermodels redesign | Set up /dev subdomain on WebSupport | WebSupport |
|
|
|
|
> Full task list: `obsidian-vault/Tasks.md`
|
|
|
|
---
|
|
|
|
## 🧠 Life OS — Obsidian Vault Structure
|
|
|
|
| Folder | Purpose |
|
|
|---|---|
|
|
| `00 Inbox` | Capture everything first |
|
|
| `01 Goals` | Long-term goals |
|
|
| `02 Projects` | Active projects (each has its own `.md`) |
|
|
| `03 Areas` | Ongoing responsibilities (Homelab, Main PC, Personal Admin) |
|
|
| `04 Daily Notes` | Daily log |
|
|
| `05 Resources` | Reference material |
|
|
| `06 Archive` | Completed/inactive items |
|
|
| `Tasks.md` | Master task dashboard (hand-curated) |
|
|
|
|
**Sync**: Obsidian Git plugin on PC → Gitea `spendlik/obsidian-vault`; MGit on Android
|
|
|
|
---
|
|
|
|
## 🛠️ Automation Stack
|
|
|
|
| Layer | Tool | Location |
|
|
|---|---|---|
|
|
| Scheduling / plumbing | n8n | CT 100 / automation.spendlik.sk |
|
|
| AI content generation | Claude API (claude-sonnet) | via n8n HTTP node |
|
|
| Agentic coding assistant | Claude Code 2.1.173 | CachyOS main PC (VSCodium extension) |
|
|
| Notifications | Matrix (automation alerts) | CT 103 |
|
|
| DNS management | WebSupport REST API v2 | CT 108 |
|
|
| Affiliate site | WordPress on WebSupport hosting | kocka-novinky.sk |
|
|
|
|
---
|
|
|
|
## 🗃️ Gitea Repositories
|
|
|
|
| Repo | Visibility | Purpose |
|
|
|---|---|---|
|
|
| `Claude_Homelab` | Public | Infrastructure docs, deploy guides, this index |
|
|
| `obsidian-vault` | Private | Life OS / second brain |
|