# 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+