homelab-brain/MASTER_INDEX.md
Homelab Cursor 48852c8665 Garage-Decke Doku und Hermes-MCP ins Git versionieren.
Projektdoku, MCP-Skript und Deploy-Hinweise als Quelle der Wahrheit in homelab-brain; CT999 und Telegraf-README verlinken darauf.
2026-06-28 17:05:03 +02:00

97 lines
5.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Homelab Master Index
> Einmalig lesen für Übersicht. Danach gezielt die STATE.md des betroffenen Projekts laden.
> Variable Fakten (IPs, Tokens, Passwörter): **immer** `homelab.conf` lesen.
## Projekte
| Projekt | STATE.md | Beschreibung |
|---|---|---|
| **Arakava News** | arakava-news/STATE.md | WordPress + RSS-Manager + KI-Artikel |
| **Edelmetall Dashboard** | edelmetall/STATE.md | Gold/Silber Preisbot |
| **Smart Home** | smart-home/STATE.md | ioBroker + InfluxDB + Grafana (alle in CT 143 pve-mu-3) |
| **Garage Decke Brunnenkühlung** | docs/projekte/garage-decke-monitoring.md | 5× DS18B20, Shelly, Grafana, Hermes MCP |
| **Heizung & Ölverbrauch** | smart-home/HEIZUNG.md | Brennererkennung, Dashboard, Zugänge, Scripts |
| **ESP32 Projekte** | esp32/PLAN.md | Heizungssteuerung, Sensorik |
| **FünfVorAcht** | fuenfvoracht/STATE.md | Telegram KI-Poster (täglich 19:55) |
| **Redakteur** | redax-wp/STATE.md | WordPress KI-Autor + DeutschlandBlog |
| **Flugpreisscanner** | flugpreisscanner/STATE.md | FRA→PNH, Selenium, 3 Nodes |
| **Infrastruktur** | infrastructure/STATE.md | Alle Server + Container |
| **RAGFlow** | infrastructure/RAGFLOW.md | PDF-RAG (~20k Docs, Muldenstein) |
| **OpenMemory** | infrastructure/OPENMEMORY.md | mem0 Memory-Store + MCP (CT122), inkl. 2026-05-31 Hotfix |
| **Troubleshooting** | infrastructure/TROUBLESHOOTING.md | Runbooks: pve-mu-2 Tailscale-Key, Systemvorhersage-Fehlalarme |
| **Homelab AI Bot** | — | Hausmeister Telegram Bot (CT 116) |
| **KI-Video Pipeline** | ki-video/PLAN.md | Lokale Videoproduktion: Qwen + FLUX + XTTS + SadTalker (ki-tower) |
| **Webcam Kambodscha** | — | Dahua 4K → cam.arakavanews.com (CT 600 auf pve-ka-3) |
| **YouTube Desktop PP** | — | Remote Desktop (xrdp) für YT-Uploads (pve-pp-1/pp-2) |
| **Lokale KI / Vibe Coding** | hardware-ai-local-coding.md | Hardware-Entscheidung MacBook Pro M5 Max 128 GB, NVIDIA-Vergleich, Verkauf Alt-GPUs |
## Prioritäten
1. **Arakava News** (WordPress + RSS-Manager) — Prio 1
2. **FünfVorAcht** (Telegram KI-Poster) — Prio 1
3. Rest — bei Bedarf
## Physische Standorte
| Standort | Server | Logischer Name | Tailscale IP | Funktion |
|---|---|---|---|---|
| Hetzner DC | pve-hetzner | pve-hetzner | 100.88.230.59 | Hauptserver, alle Projekte |
| Kambodscha | pve1 | **pve-ka-1** | 100.122.56.60 | Heimserver, Edelmetall, Taxi, MCP |
| Kambodscha | pve-Shops | **pve-ka-2** | 100.120.126.95 | Shop-Templates (alle stopped) |
| Kambodscha | pve3 | **pve-ka-3** | 100.103.90.94 | Webcam, FreshRSS, LLM-Router |
| Phnom Penh | Dell 3040 | **pve-pp-1** | 100.126.26.46 | YouTube Desktop (pp-cluster) |
| Phnom Penh | Dell 3040 | **pve-pp-2** | 100.95.156.25 | Standby/Reserve (pp-cluster) |
| Muldenstein | pve2 | **pve-mu-2** | 100.99.101.37 | Pizza-Shops, PC-Shops, Taxi, Tools (20+ CTs) |
| Muldenstein | pve3 | **pve-mu-3** | 100.109.101.12 | Syncthing, WireGuard, Flugscanner, MQTT, Mirrors |
| Muldenstein | — | **pve-mu-1** | offline | Aktuell nicht erreichbar |
| Ramsin | helmut-pve | **pve-he** | 100.87.235.11 | Bei Helmut, Backup-Agent |
| Muldenstein | PBS | **pbs-mu** | 100.99.139.22 | Proxmox Backup Server |
| Muldenstein | CT 116 (pve-mu-2) | **monitoring-bot** | 100.88.230.74 | Cursor IDE + Tailscale-Gateway + SSH-Hub |
| Muldenstein | ki-tower | **ki-tower** (in Bau) | — | **Jellyfin-Ersatz** (Medienserver) — KEINE KI-Rolle |
| Muldenstein | MSI B550 | **test-rig** (in Bau) | — | Test-Bett für alte 3080er/AMD-Karten vor Verkauf |
| Muldenstein | AMD-Rig | **gpu-reserve** | — | 8x RX 6600 XT — Verkauf |
| mobil | MacBook Pro 16" | **m5-max** | — | M5 Max 128 GB / 2 TB — lokale KI / Vibe Coding / Jervais (Stand 2026-04-26, siehe hardware-ai-local-coding.md) |
| — | — | — | — | **Lokale KI: M5 Max** (mobil) + **CUDA-Pflicht: KI-Server RTX 3090**. Kein 2× 5090, kein zweiter NVIDIA-Build. |
## Telegram Bots
| Bot | Projekt | Beschreibung |
|---|---|---|
| @MutterbotAI_bot | Arakava News | RSS-Alerts, Kommentar-Moderation |
| @Diendemleben_bot | FünfVorAcht | Täglicher KI-Post 19:55 |
| Edelmetall Bot | Edelmetall | Gold/Silber Preise |
| @Hausmeister_bot | Homelab AI Bot | Infrastruktur-Monitoring, KI-Fragen |
## TODO-Liste
**Zentral in Forgejo (Repo `orbitalo/homelab-brain`):**
- Web: http://100.89.246.60:3000/orbitalo/homelab-brain/issues
- Details: siehe `homelab.conf` (FORGEJO_TOKEN)
## Deployment
**Code-Änderungen deployen — EIN Befehl:**
```bash
./scripts/deploy.sh "Beschreibung"
```
Ablauf: `git commit → push Forgejo → Bot restart`
Das Skript erkennt automatisch ob es auf pve-hetzner oder remote läuft.
**Architektur:**
```
Cursor (pve-hetzner) → Forgejo (CT 111) → /opt/homelab-brain/
↓ Bind-Mount (mp0 in CT 116 Config)
CT 116 /opt/homelab-ai-bot/
```
CT 116 liest direkt aus dem Git-Repo über einen LXC Bind-Mount.
Kein `scp` oder `pct push` nötig. Fallback: Cursor auf pve-ka-1 (100.122.56.60).
## Auto-Sync
- `sync-state.sh` / `sync_state.py` — läuft alle 15 Min auf pve-hetzner
- Generiert STATE.md Dateien automatisch
- Watchdog mit Telegram-Alerts bei Ausfällen
- Monitor-Cron (`*/5`) prüft proaktiv auf Fehler (panic/fatal/OOM)
- **Achtung:** sync-state.sh macht `git reset --hard` — lokale Änderungen
ohne Push werden überschrieben!