feat: Initial stacks for testing

Added first test stacks:
- monitoring/prometheus
- monitoring/grafana
- monitoring/node-exporter
- communication/gotify
- communication/vaultwarden

All stacks:
- Use localhost ports only (for Caddy reverse proxy)
- Support Komodo Secrets via ${SECRET:secret-name}
- Include README with Caddy integration instructions
- Ready for Komodo v2 Resource Sync
This commit is contained in:
nocci 2026-03-09 16:02:18 +00:00
commit f9fdea3a1f
11 changed files with 663 additions and 0 deletions

175
README.md Normal file
View file

@ -0,0 +1,175 @@
# Komodo Stacks
🦎 **Docker Compose Stacks für Komodo Platform**
Diese Stacks sind für den Einsatz mit **Komodo Core v2** optimiert.
---
## 📁 Struktur
```
komodo-stacks/
├── stacks/
│ ├── monitoring/ # Prometheus, Grafana, Node Exporter
│ ├── communication/ # Vaultwarden, Gotify, Ntfy
│ ├── collaboration/ # Nextcloud, Forgejo, WordPress
│ ├── media/ # Immich, Jellyfin, Plex
│ ├── infrastructure/ # WireGuard, Portainer
│ ├── security/ # Authentik, Tinyauth
│ ├── social/ # GoToSocial, Sharkey
│ ├── gaming/ # Pterodactyl
│ ├── utilities/ # SearXNG, Plausible
│ └── backup/ # Backrest, Karakeep
└── README.md
```
---
## 🚀 Verwendung in Komodo
1. **Settings → Resources → Add Resource**
2. **Git URL:** `https://git.sky-net.it/nocci/komodo-stacks.git`
3. **Path:** `stacks/`
4. **Sync** klicken
---
## 📋 Stacks deployen
1. **Ressources** im Komodo Dashboard öffnen
2. **Stack auswählen**
3. **Server wählen** (wo Periphery läuft)
4. **Deploy** klicken
5. **Warten** bis Container laufen
---
## 🔧 Caddy Integration
**WICHTIG:** Stacks hören nur auf `localhost:PORT`!
Nach dem Deployen, Caddy Config auf dem Server bearbeiten:
```bash
ssh <server>
sudo nano /etc/caddy/Caddyfile
```
Beispiel für Prometheus:
```caddyfile
prometheus.example.com {
reverse_proxy localhost:9090
}
```
Dann:
```bash
sudo systemctl reload caddy
```
---
## 🔐 Secrets
Secrets werden über **Komodo Secrets** verwaltet.
Im `compose.yml`:
```yaml
environment:
- ADMIN_PASSWORD=${SECRET:my-admin-password}
```
In Komodo:
1. **Settings → Secrets**
2. **Add Secret**
3. Name: `my-admin-password`
4. Wert: sicheres Passwort
---
## 📦 Verfügbare Stacks
### Monitoring
- [prometheus](stacks/monitoring/prometheus/) - Prometheus Monitoring
- [grafana](stacks/monitoring/grafana/) - Grafana Dashboards
- [node-exporter](stacks/monitoring/node-exporter/) - System Metrics
- [promtail](stacks/monitoring/promtail/) - Log Collector
- [loki](stacks/monitoring/loki/) - Log Aggregation
### Communication
- [vaultwarden](stacks/communication/vaultwarden/) - Password Manager
- [gotify](stacks/communication/gotify/) - Push Notifications
- [ntfy](stacks/communication/ntfy/) - Notification Service
### Collaboration
- [nextcloud-aio](stacks/collaboration/nextcloud-aio/) - Cloud Storage
- [forgejo](stacks/collaboration/forgejo/) - Git Server
- [wordpress](stacks/collaboration/wordpress/) - CMS
### Media
- [immich](stacks/media/immich/) - Photo Backup
- [jellyfin](stacks/media/jellyfin/) - Media Server
### Infrastructure
- [wireguard](stacks/infrastructure/wireguard/) - VPN Server
- [portainer](stacks/infrastructure/portainer/) - Docker UI
### Security
- [authentik](stacks/security/authentik/) - SSO Provider
- [tinyauth](stacks/security/tinyauth/) - Simple Auth
### Social
- [gotosocial](stacks/social/gotosocial/) - ActivityPub Server
- [sharkey](stacks/social/sharkey/) - Fediverse Server
### Gaming
- [pterodactyl-panel](stacks/gaming/pterodactyl-panel/) - Game Panel
- [pterodactyl-wings](stacks/gaming/pterodactyl-wings/) - Game Daemon
### Utilities
- [searxng](stacks/utilities/searxng/) - Meta Search Engine
- [plausible](stacks/utilities/plausible/) - Web Analytics
- [webcheck](stacks/utilities/webcheck/) - Uptime Monitor
### Backup
- [backrest](stacks/backup/backrest/) - Backup Server
- [karakeep](stacks/backup/karakeep/) - Bookmark Manager
---
## 🛠️ Troubleshooting
### Stack wird nicht angezeigt
1. **Resource Sync** im Dashboard manuell ausführen
2. **Git URL prüfen**
3. **Path prüfen** (muss `stacks/` sein)
### Container starten nicht
1. **Logs prüfen** im Komodo Dashboard
2. **Secrets konfiguriert?**
3. **Ports belegt?**
### Caddy Proxy funktioniert nicht
1. **Caddy Config prüfen:** `sudo caddy validate`
2. **DNS Records** zeigen auf Server-IP?
3. **Firewall** Ports 80/443 offen?
---
## 📝 Eigene Stacks hinzufügen
1. **Ordner erstellen:** `stacks/<category>/<stack-name>/`
2. **compose.yml** erstellen
3. **README.md** mit Infos
4. **Commit & Push**
---
**Author:** nocci
**Version:** 1.0.0
**License:** MIT
**Komodo Version:** v2.0.0-dev-123+