Binary Data: Filesystem/S3 statt Datenbank

Wenn ein n8n-Workflow PDFs, Bilder oder andere Dateien verarbeitet, muss n8n diese Binärdaten irgendwo zwischenspeichern, bevor sie an den nächsten Node weitergereicht werden. Ohne explizite Konfiguration landen diese Daten im Arbeitsspeicher oder, je nach Betriebsmodus, in der Datenbank selbst, was bei größeren Dateien oder vielen parallelen Ausführungen schnell zu Speicherproblemen und einer aufgeblähten Datenbank führt. Die offizielle n8n-Dokumentation zur Verarbeitung von Binärdaten im großen Maßstab empfiehlt deshalb für produktive Instanzen den Wechsel auf den Filesystem-Modus oder, bei Self-Hosted-Enterprise-Lizenzen, auf externen S3-Speicher. Stand: Juli 2026.

Warum die Datenbank für Binärdaten ungeeignet ist

n8n hält Binärdaten standardmäßig im Arbeitsspeicher, was laut Dokumentation bei großen Dateien zu Abstürzen führen kann. Läuft eine Instanz im Queue-Modus mit mehreren Workern, unterstützt n8n den Filesystem-Modus nicht, und die Binärdaten müssen stattdessen im Datenbank-Modus abgelegt werden. Das Problem dabei: Eine relationale Datenbank ist für viele kleine, strukturierte Zeilen ausgelegt, nicht für große Binär-Blobs. Wachsen die gespeicherten Dateien, wächst auch die Datenbank spürbar mit, was Backups, Replikation und normale Abfragen verlangsamt. Genau hier setzt die Umstellung auf Filesystem- oder S3-Speicherung an.

Filesystem-Modus: der pragmatische erste Schritt

Für selbstgehostete n8n-Instanzen außerhalb des Queue-Modus ist der Filesystem-Modus die einfachste Lösung. Er lässt sich über die Umgebungsvariable N8N_DEFAULT_BINARY_DATA_MODE mit dem Wert filesystem aktivieren, wodurch n8n Binärdaten auf die Festplatte statt in den Arbeitsspeicher schreibt. Der Speicherort lässt sich über N8N_BINARY_DATA_STORAGE_PATH anpassen, standardmäßig liegt er unter N8N_USER_FOLDER/binaryData. Zusätzlich definiert N8N_AVAILABLE_BINARY_DATA_MODES, welche Modi überhaupt verfügbar sind, als kommagetrennte Liste mit filesystem als Standardwert. Details zu allen Variablen listet die n8n-Dokumentation zu Umgebungsvariablen für Binärdaten. Wichtig für Betreiber: Läuft die Instanz im Queue-Modus, ist dieser Weg laut Dokumentation nicht nutzbar, hier bleibt nur der Datenbank-Modus oder S3.

S3-Modus: externe Speicherung für skalierende Deployments

Wer n8n im größeren Stil betreibt oder auf mehrere Worker-Instanzen setzt, kann Binärdaten in einem S3-kompatiblen Objektspeicher ablegen. Dieser Modus ist laut n8n-Dokumentation zur externen Speicherung nur auf Self-Hosted-Enterprise-Plänen verfügbar und benötigt einen gültigen Enterprise-Lizenzschlüssel, ohne den die Instanz im S3-Modus gar nicht erst startet. Die Konfiguration erfolgt über mehrere Variablen.

• N8N_EXTERNAL_STORAGE_S3_HOST: der S3-Endpunkt, etwa s3.us-east-1.amazonaws.com
• N8N_EXTERNAL_STORAGE_S3_BUCKET_NAME: der Name des Buckets
• N8N_EXTERNAL_STORAGE_S3_BUCKET_REGION: die Region, ab Version 2.6.4 nur alphanumerische Zeichen und Bindestriche, ohne Region-Vorgabe reicht der Wert auto
• N8N_EXTERNAL_STORAGE_S3_ACCESS_KEY und N8N_EXTERNAL_STORAGE_S3_ACCESS_SECRET: Zugangsdaten für den Bucket
• N8N_EXTERNAL_STORAGE_S3_AUTH_AUTO_DETECT: optional auf true, um Zugangsdaten automatisch zu erkennen, etwa über eine IAM-Rolle

Aktiviert wird der Modus über N8N_AVAILABLE_BINARY_DATA_MODES=filesystem,s3 zusammen mit N8N_DEFAULT_BINARY_DATA_MODE=s3, gefolgt von einem Neustart der Instanz. Binärdaten landen dann strukturiert unter workflows/{workflowId}/executions/{executionId}/binary_data/{binaryFileId} im Bucket.

Die Migration sauber vorbereiten

Vor der Umstellung sollten Sie den Bucket samt IAM-Policy für die nötigen S3-Aktionen einrichten und eine Lifecycle-Regel setzen, die alte Binärdaten automatisch löscht, denn n8n übernimmt dieses Aufräumen laut Dokumentation nicht automatisch. Ein weiterer Punkt, den man leicht übersieht: Das Pruning von Binärdaten wirkt jeweils nur auf den aktuell aktiven Modus. Wechseln Sie von Datenbank- auf Filesystem- oder S3-Modus, bleiben ältere Binärdaten im bisherigen Speicherort liegen und müssen separat aufgeräumt werden. Wer eine n8n-Instanz produktiv mit wachsendem Datenvolumen betreibt, plant diesen Wechsel besser früh, statt erst zu reagieren, wenn die Datenbank spürbar langsamer wird. NordFlux unterstützt bei der n8n-Einrichtung inklusive einer Speicherkonfiguration, die zum tatsächlichen Datenvolumen passt.

Häufige Fragen zu Binärdaten in n8n

Was ist der Unterschied zwischen Filesystem- und S3-Modus?

Der Filesystem-Modus schreibt Binärdaten auf die lokale Festplatte des n8n-Servers und eignet sich für einzelne, nicht im Queue-Modus laufende Instanzen. Der S3-Modus lagert die Daten in einen externen Objektspeicher aus und ist für verteilte Setups mit mehreren Workern gedacht, erfordert dafür aber eine Self-Hosted-Enterprise-Lizenz.

Brauche ich für den S3-Modus zwingend eine Enterprise-Lizenz?

Ja. Laut n8n-Dokumentation startet die Instanz im S3-Modus ohne gültigen Enterprise-Lizenzschlüssel nicht. Für kleinere, nicht im Queue-Modus laufende Setups reicht in der Regel der kostenlose Filesystem-Modus aus.

Funktioniert der Filesystem-Modus auch im Queue-Modus?

Nein. n8n unterstützt den Filesystem-Modus nicht in Kombination mit dem Queue-Modus. Betreiber mit mehreren Workern müssen stattdessen entweder den Datenbank-Modus oder, mit passender Lizenz, den S3-Modus verwenden.

Was passiert mit bereits gespeicherten Binärdaten beim Wechsel des Modus?

Sie werden nicht automatisch migriert oder gelöscht. Das Pruning arbeitet immer nur auf dem aktuell eingestellten Modus, alte Dateien im vorherigen Speicherort bleiben also liegen und müssen manuell bereinigt werden.