Nachdem ich auf 3.5.0 ein Update gemacht habe lief mein Paperless nicht mehr (Bad Request (400)
Claude sagt dazu:
Mein Paperless läuft jetzt wieder.
PR #14735 in 3.5.0 hat das Standard-Verhalten von ALLOWED_HOSTS geändert: Sobald PAPERLESS_URL gesetzt ist, beschränkt sich ALLOWED_HOSTS jetzt auf den Hostnamen aus der PAPERLESS_URL plus localhost. Vorher war der Standard * (alle Hosts erlaubt), unabhängig davon ob PAPERLESS_URL gesetzt war oder nicht. github
Das bedeutet: Alles, was Paperless mit einem anderen Hostnamen/einer anderen IP anspricht (z.B. lokale IP-Adresse, interner Docker-Hostname, Reverse-Proxy), bekommt jetzt einen 400 DisallowedHost-Fehler von Django.
Fix: PAPERLESS_ALLOWED_HOSTS explizit setzen
In deiner docker-compose.env oder den Umgebungsvariablen hinzufügen:
env
PAPERLESS_ALLOWED_HOSTS=deinhost.domain.tld,192.168.1.x,localhost,127.0.0.1
Oder wenn du mehrere Zugriffswege hast (lokale IP, Subdomain, etc.):
env
PAPERLESS_ALLOWED_HOSTS=*
Der Wildcard * entspricht dem alten Verhalten vor 3.5.0 und ist für ein privates Heimnetz völlig akzeptabel.
Typische Szenarien für den Fehler:
| Situation | Problem |
|---|---|
Zugriff per lokaler IP (z.B. 192.168.1.x) aber PAPERLESS_URL = externe Domain |
IP ist nicht in ALLOWED_HOSTS |
| Reverse Proxy übergibt internen Hostnamen | Hostname stimmt nicht mit PAPERLESS_URL überein |
| Paperless-AI oder andere Tools greifen per Container-Name auf die API zu | Container-Name nicht erlaubt |
| Health-Probes (Kubernetes/Docker) per Pod-IP | IP nicht in ALLOWED_HOSTS |
Vollständiges Beispiel für eine typische Heiminstallation mit externem Zugriff:
env
PAPERLESS_URL=https://paperless.deine-domain.de
PAPERLESS_ALLOWED_HOSTS=paperless.deine-domain.de,192.168.1.x,localhost,127.0.0.1
PAPERLESS_CSRF_TRUSTED_ORIGINS=https://paperless.deine-domain.de
bash
docker compose down && docker compose up -d