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:

ssh <server>
sudo nano /etc/caddy/Caddyfile

Beispiel für Prometheus:

prometheus.example.com {
    reverse_proxy localhost:9090
}

Dann:

sudo systemctl reload caddy

---

🔐 Secrets

Secrets werden über Komodo Secrets verwaltet.

Im compose.yml:

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 - Prometheus Monitoring
• grafana - Grafana Dashboards
• node-exporter - System Metrics
• promtail - Log Collector
• loki - Log Aggregation

Communication

• vaultwarden - Password Manager
• gotify - Push Notifications
• ntfy - Notification Service

Collaboration

• nextcloud-aio - Cloud Storage
• forgejo - Git Server
• wordpress - CMS

Media

• immich - Photo Backup
• jellyfin - Media Server

Infrastructure

• wireguard - VPN Server
• portainer - Docker UI

Security

• authentik - SSO Provider
• tinyauth - Simple Auth

Social

• gotosocial - ActivityPub Server
• sharkey - Fediverse Server

Gaming

• pterodactyl-panel - Game Panel
• pterodactyl-wings - Game Daemon

Utilities

• searxng - Meta Search Engine
• plausible - Web Analytics
• webcheck - Uptime Monitor

Backup

• backrest - Backup Server
• 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+