Stand: 19.10.2026
Authelia Docker Compose schützt mehrere selbst gehostete Webdienste mit einer zentralen Anmeldung. Zusammen mit Traefik setzt du dafür einen eigenen Authentifizierungsdienst vor deine Anwendungen. Entscheidend sind HTTPS, korrekt gesetzte Session-Cookies und eine restriktive Zugriffsregel.
Auf einen Blick
- Authelia ergänzt einen Reverse Proxy um Anmeldung und Zugriffskontrolle.
- Traefik prüft geschützte Anfragen über eine ForwardAuth-Middleware.
- Für einen Test reichen Dateinutzer und SQLite; produktiv sind PostgreSQL, Redis und SMTP die bessere Wahl.
- Geheimnisse gehören in Dateien oder einen Secret-Store, nie in das Compose-Repository.
- Beginne mit
default_policy: denyund gib nur benötigte Hosts frei.
Was leistet Authelia vor Traefik?
Authelia ist ein Open-Source-Dienst für Authentifizierung und Autorisierung. Er passt vor allem zu einem Homelab mit mehreren Webanwendungen hinter einem Reverse Proxy. Statt jede Anwendung einzeln mit einer Login-Schicht zu versehen, leitet Traefik die Anfrage an Authelia weiter. Erst nach einer gültigen Sitzung erreicht sie den Dienst.
Das ist ForwardAuth. Anwendungen, die OpenID Connect direkt unterstützen, können stattdessen Authelia als Identity Provider verwenden. Dieser Artikel behandelt bewusst den vorgeschalteten Schutz durch Traefik. Die Grundlage dafür zeigt die Anleitung zu Traefik im Homelab mit Docker Compose.
Welche Voraussetzungen braucht Authelia Docker Compose?
Du brauchst Docker Compose, ein vorhandenes Docker-Netzwerk für den Proxy sowie DNS-Namen für das Login-Portal und die geschützten Dienste. Authelia verlangt für diesen Ablauf HTTPS: Das Portal und die geschützten Anwendungen arbeiten mit sicheren Session-Cookies. Ein gültiges Zertifikat und passende Hostnamen sind daher keine spätere Optimierung.
Lege Konfiguration, Geheimnisse und Daten getrennt ab. So bleiben sie bei einem Container-Neustart erhalten und gelangen nicht versehentlich in Git. Wenn Bind Mounts und Netzwerke noch neu für dich sind, lies zuerst die Docker-Compose-Grundlagen.
Wie bereitest du Verzeichnisse und Geheimnisse vor?
- Erstelle ein Projektverzeichnis mit
configundsecrets. - Lege für Sitzungen, Speicher-Verschlüsselung und Passwort-Reset jeweils ein separates langes Zufallsgeheimnis an.
- Beschränke die Leserechte der Secret-Dateien auf den Dienst-Account.
- Sichere Konfiguration und später auch die Datenbank, bevor du ein Image aktualisierst.
mkdir -p authelia/{config,secrets}
chmod 700 authelia/secrets
openssl rand -base64 48 > authelia/secrets/SESSION_SECRET
openssl rand -base64 48 > authelia/secrets/STORAGE_ENCRYPTION_KEY
openssl rand -base64 48 > authelia/secrets/JWT_SECRET
chmod 600 authelia/secrets/*Prüfe den verwendeten Befehl auf deinem System, bevor du ihn übernimmst. Die offiziellen Docker-Beispiele von Authelia unterstützen Secret-Dateien über Variablen mit der Endung _FILE. Das ist sicherer als Klartextwerte in Labels oder einer eingecheckten .env-Datei.
Wie sieht eine schlanke Compose-Datei aus?
Das folgende Beispiel verbindet Authelia mit einem bereits vorhandenen externen Netzwerk namens proxy. Es ist ein Ausgangspunkt, keine vollständige Produktionskonfiguration. Pinne nach einem getesteten Update einen konkreten Image-Tag statt dauerhaft latest zu verwenden.
services:
authelia:
image: docker.io/authelia/authelia:latest
container_name: authelia
restart: unless-stopped
networks:
proxy: {}
volumes:
- ./config:/config
- ./secrets:/secrets:ro
environment:
AUTHELIA_IDENTITY_VALIDATION_RESET_PASSWORD_JWT_SECRET_FILE: /secrets/JWT_SECRET
AUTHELIA_SESSION_SECRET_FILE: /secrets/SESSION_SECRET
AUTHELIA_STORAGE_ENCRYPTION_KEY_FILE: /secrets/STORAGE_ENCRYPTION_KEY
networks:
proxy:
external: trueFür einen kleinen, isolierten Test kann das Datei-Backend für Nutzer genügen. Für dauerhaft genutzte Installationen dokumentiert Authelia PostgreSQL für den Speicher, Redis für Sitzungen und SMTP für Benachrichtigungen. Der Datei-Notifier ist nur für Tests gedacht. Ergänze daher kein Beispiel blind, sondern wähle die Komponenten passend zu deinem Betrieb.
Welche Konfiguration ist zwingend?
Authelia wird über eine Konfigurationsdatei eingerichtet. Du brauchst mindestens ein Identity-Backend, Speicher, Sessions, Benachrichtigungen und Regeln für den Zugriff. Starte restriktiv: Mit default_policy: deny ist eine neue Subdomain nicht aus Versehen öffentlich erreichbar.
authentication_backend:
file:
path: /config/users.yml
access_control:
default_policy: deny
rules:
- domain: '*.example.net'
policy: one_factor
session:
cookies:
- domain: example.net
authelia_url: https://auth.example.net
default_redirection_url: https://start.example.netErsetze jede Beispiel-Domain vollständig durch deine eigene Domain. Die Cookie-Domain muss zu den geschützten Hosts passen. Verwende für neue Passwort-Hashes den von Authelia dokumentierten Algorithmus argon2id. Danach aktivierst du einen zweiten Faktor und testest die Regeln zunächst mit einem einzigen Dienst.
Wie verbindest du Traefik mit Authelia?
Die aktuelle Authelia-Integration für Traefik verwendet den Endpoint /api/authz/forward-auth. Die Middleware kann bei Authelia oder bei Traefik definiert werden. Bei getrennten Compose-Stacks ist die Definition am Traefik-Container oft übersichtlicher; beide Container müssen dafür das gleiche Docker-Netzwerk nutzen.
labels:
traefik.enable: 'true'
traefik.http.routers.authelia.rule: 'Host(`auth.example.net`)'
traefik.http.routers.authelia.entryPoints: 'https'
traefik.http.routers.authelia.tls: 'true'
traefik.http.middlewares.authelia.forwardAuth.address: 'http://authelia:9091/api/authz/forward-auth'
traefik.http.middlewares.authelia.forwardAuth.trustForwardHeader: 'true'
traefik.http.middlewares.authelia.forwardAuth.authResponseHeaders: 'Remote-User,Remote-Groups,Remote-Email,Remote-Name'Am geschützten Router verweist du anschließend auf authelia@docker. Richte zuerst das Portal unter auth.example.net ein. Erst wenn An- und Abmeldung sauber funktionieren, sicherst du weitere Dienste ab. Für den Betrieb helfen außerdem ein Docker-Healthcheck und ein unabhängiges Uptime-Monitoring.
Welche Sicherheitsfehler solltest du vermeiden?
Vertraue weitergereichten Headern nur von Proxys, die du selbst kontrollierst. Trage nicht pauschal ein ganzes Docker- oder LAN-Netz als vertrauenswürdig ein, wenn dort auch andere Dienste laufen. Traefik vertraut Proxys standardmäßig nicht automatisch; behalte diese Haltung bei und ergänze nur nötige, konkrete Adressen.
Schütze auch die Umgebung um Authelia: Updates kontrolliert einspielen, Backups testen und keine Verwaltungsoberflächen offen ins Internet stellen. Die allgemeinen Maßnahmen aus Docker Security Tipps gelten ebenso für diesen Stack.
Typische Fehler und ihre Lösung
| Problem | Ursache | Lösung |
|---|---|---|
| Login-Schleife | Cookie-Domain, Portal-URL oder HTTPS passt nicht. | Prüfe session.cookies, Hostnamen und Zertifikate. |
| Middleware nicht gefunden | Die Container teilen kein Netzwerk oder die Definition liegt im falschen Stack. | Netzwerk und Provider-Suffix prüfen; bei Docker meist authelia@docker. |
| Container startet nicht | Eine Konfigurationsdatei oder ein Secret fehlt. | Mount-Pfade und Dateirechte prüfen, dann die Validierungsausgabe lesen. |
| Passwort-Reset kommt nicht an | Der Datei-Notifier wird außerhalb eines Tests verwendet. | Für den Produktivbetrieb SMTP konfigurieren. |
Fazit
Authelia Docker Compose schafft eine zentrale Schutzschicht für Dienste hinter Traefik. Der sichere Weg beginnt mit HTTPS, getrennten Secrets und einer deny-by-default-Regel. Danach schützt du einen Dienst nach dem anderen und prüfst jeden Login-Ablauf, bevor du weitere Regeln ausrollst.
Quellen
- Authelia: Docker Deployment
- Authelia: Traefik Integration
- Authelia: File Authentication Backend
- Authelia: File-System Notifier
Häufige Fragen
Authelia ist ein Dienst für Anmeldung und Zugriffskontrolle vor Webanwendungen. Mit einem Reverse Proxy wie Traefik schützt es mehrere selbst gehostete Dienste über eine zentrale Sitzung.
Ja. Die offizielle Dokumentation enthält Docker-Beispiele mit persistentem Konfigurationsverzeichnis und getrennten Secret-Dateien. Für den produktiven Betrieb sind PostgreSQL, Redis und SMTP die üblichen Bausteine.
Traefik ruft über eine ForwardAuth-Middleware den Authelia-Endpunkt /api/authz/forward-auth auf. Der Router eines geschützten Dienstes verweist danach auf diese Middleware.
Ja. Für das Portal und die über ForwardAuth geschützten Anwendungen ist HTTPS erforderlich, weil der Ablauf sichere Session-Cookies verwendet.
Nein. Der Datei-Notifier ist für Tests vorgesehen. Für echte Passwort-Resets und Benachrichtigungen richtest du einen SMTP-Notifier ein.





Schreibe einen Kommentar