Zum Inhalt

CaddyManager

Einleitung und Rolle

CaddyManager ist eine Verwaltungsoberfläche für Caddy-Konfigurationen und die Caddy-Admin-API. Wichtig ist die Abgrenzung: CaddyManager ist nicht die Source of Truth für die normalen Selfhost-Routen. Die verbindliche Quelle bleibt /opt/selfhost/registry/routes.json; daraus erzeugt der Generator die Caddy- und Homepage-Konfiguration.

Persistente Daten und Backup-Relevanz

Pfad Bedeutung Backup-Relevanz
/opt/selfhost/data/caddymanager/sqlite SQLite-Datenbank des Backends hoch
/opt/selfhost/secrets/caddymanager.env JWT_SECRET und weitere Secrets hoch, Werte nicht dokumentieren
/opt/selfhost/stacks/caddymanager/docker-compose.yml Stack-Definition hoch

Stack, Container und Docker Compose

Eigenschaft Wert
Stack /opt/selfhost/stacks/caddymanager/
Container caddymanager-backend, caddymanager-frontend
Images caddymanager/caddymanager-backend:latest, caddymanager/caddymanager-frontend:latest
Frontend-Port 127.0.0.1:8020:80
Backend-Port intern 3000
Datenbank SQLite unter /app/data/caddymanager.sqlite
Caddy Admin API http://172.17.0.1:2019

Route und Caddy

Registry-ID Hostname Upstream
caddymanager caddymanager.marcosudau.com http://127.0.0.1:8020

Zugehörige Dienste und Abhängigkeiten

Abhängigkeit Rolle
Caddy Admin API Lesen/Verwalten von Caddy-Konfigurationen
Registry-Verfahren bleibt die verbindliche Selfhost-Routenquelle

Secrets und Umgebungsvariablen

Key Zweck
JWT_SECRET Signatur von CaddyManager-Sessions/Tokens

Betrieb und Prüfung

sudo docker compose ls
sudo docker ps --format '{{.Names}} {{.Status}}'
curl -I https://caddymanager.marcosudau.com