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
175 lines
4.2 KiB
Markdown
175 lines
4.2 KiB
Markdown
# 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+
|