Leitfaden: nginx - Fehler „413 Request Entity Too Large“ beheben

Beim Hochladen von Dateien auf eine Website kann es vorkommen, dass der Upload mit folgendem Fehler abbricht:

413 Request Entity Too Large

Dieser Fehler tritt auf, wenn eine Datei größer ist, als nginx standardmäßig akzeptiert.
Der Grund: nginx begrenzt die Größe von Uploads über die Direktive client_max_body_size.

• Standardwert: 1 MB
• Wenn der im Header Content-Length angegebene Wert diesen Grenzwert überschreitet, blockiert nginx den Upload und gibt Fehler 413 zurück.

Gerade bei Dateiuploads in Webanwendungen (z.B. Bilder, PDFs oder Videos) ist das Limit von 1 MB oft zu klein. Zum Glück lässt sich der Wert mit einer einfachen Einstellung anpassen.

Um größere Uploads zuzulassen, einfach in der nginx-Konfiguration einen höheren Wert setzen, z.B. 100 MB:

client_max_body_size 100M;

Falls keine Begrenzung gewünscht ist, kann die Prüfung auch komplett abgeschaltet werden:

client_max_body_size 0;

Die Direktive client_max_body_size kann in verschiedenen Kontexten gesetzt werden:

• http {} -> für alle Hosts und Webseiten
• server {} -> für eine bestimmte Domain
• location {} -> für einzelne Pfade oder Upload-Verzeichnisse

Beispiel für eine Domain:

server {
    server_name example.com;

    client_max_body_size 100M;

    location /uploads {
        # weitere Konfiguration
    }
}

Nach jeder Anpassung muss nginx neu geladen werden:

/etc/init.d/nginx reload

oder

systemctl reload nginx

Mit der Direktive client_max_body_size können Sie flexibel festlegen, wie groß Uploads in Ihrer nginx-Umgebung sein dürfen - oder die Prüfung komplett deaktivieren. So lassen sich Upload-Fehler zuverlässig vermeiden.

Geschafft! Ab sofort sind Ihre nginx-Server auch für größere Datei-Uploads gerüstet, ohne dass der Fehler 413 Request Entitiy Too Large auftritt!

Noch mehr Anleitungen ▶