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: deny und 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?

  1. Erstelle ein Projektverzeichnis mit config und secrets.
  2. Lege für Sitzungen, Speicher-Verschlüsselung und Passwort-Reset jeweils ein separates langes Zufallsgeheimnis an.
  3. Beschränke die Leserechte der Secret-Dateien auf den Dienst-Account.
  4. 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: true

Fü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.net

Ersetze 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

ProblemUrsacheLösung
Login-SchleifeCookie-Domain, Portal-URL oder HTTPS passt nicht.Prüfe session.cookies, Hostnamen und Zertifikate.
Middleware nicht gefundenDie Container teilen kein Netzwerk oder die Definition liegt im falschen Stack.Netzwerk und Provider-Suffix prüfen; bei Docker meist authelia@docker.
Container startet nichtEine Konfigurationsdatei oder ein Secret fehlt.Mount-Pfade und Dateirechte prüfen, dann die Validierungsausgabe lesen.
Passwort-Reset kommt nicht anDer 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

Häufige Fragen

Was ist Authelia?

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.

Kann ich Authelia mit Docker Compose betreiben?

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.

Wie verbinde ich Authelia mit Traefik?

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.

Braucht Authelia HTTPS?

Ja. Für das Portal und die über ForwardAuth geschützten Anwendungen ist HTTPS erforderlich, weil der Ablauf sichere Session-Cookies verwendet.

Ist der Datei-Notifier für den Produktivbetrieb geeignet?

Nein. Der Datei-Notifier ist für Tests vorgesehen. Für echte Passwort-Resets und Benachrichtigungen richtest du einen SMTP-Notifier ein.