Paperless-ngx einrichten 2026: Das papierlose Büro selbst hosten

Paperless-ngx ist ein selbst gehostetes Dokumentenmanagement-System, mit dem du Briefe, Rechnungen und Verträge einscannst, per OCR durchsuchbar machst und danach nie wieder einen Aktenordner durchwühlen musst. Statt Papierstapel und PDF-Chaos auf der Festplatte bekommst du ein durchsuchbares Archiv, das auf deinem eigenen Server läuft — ohne Cloud-Abo, ohne dass ein Anbieter deine Kontoauszüge mitliest. Ich nutze Paperless seit gut zwei Jahren und würde nicht mehr zurück. Hier zeige ich dir, wie du es einrichtest, deine Dokumente reinbekommst und wo die Grenzen liegen.

Wie Paperless-ngx eigentlich arbeitet

Das Prinzip ist erfrischend simpel. Es gibt einen sogenannten Consume-Ordner — ein überwachtes Verzeichnis. Alles, was du dort ablegst, greift sich Paperless automatisch und schiebt es durch seine Verarbeitungskette. Zuerst läuft eine OCR-Texterkennung (Optical Character Recognition) über das Dokument. Das ist der Kern der ganzen Sache: Aus einem eingescannten Bild wird durchsuchbarer Text. Wichtig für uns in Deutschland — die OCR-Sprache muss auf Deutsch stehen, sonst macht die Erkennung aus jedem „ü“ ein „ii“ und die Volltextsuche wird wertlos.

Danach versucht Paperless, das Dokument einzuordnen. Es vergibt Tags, ordnet einen Korrespondenten zu (den Absender, etwa deine Krankenkasse oder den Vermieter) und erkennt den Dokumenttyp (Rechnung, Vertrag, Kontoauszug). Das Clevere daran: Paperless lernt mit. Anfangs taggst du selbst, aber nach den ersten Dutzend Dokumenten fängt der Klassifikator an, korrekt vorzuschlagen. Nach fünfzig einsortierten Dokumenten trifft er erstaunlich oft ins Schwarze.

Dein Original bleibt dabei immer unangetastet. Zusätzlich erzeugt Paperless eine PDF/A-Archivkopie mit eingebettetem Textlayer — das Format für Langzeitarchivierung. So gehen durch die Verarbeitung nie Daten verloren. Die Volltextsuche durchsucht am Ende erkannten Text und Metadaten, und zwar richtig schnell.

Was du dafür brauchst

Paperless-ngx läuft über Docker Compose, und das macht die Sache angenehm portabel. Du brauchst also einen Rechner, auf dem Docker läuft: einen kleinen Homeserver, ein eigenes NAS, eine virtuelle Maschine unter Proxmox oder auch einen Raspberry Pi als Homeserver. Der RAM-Bedarf ist moderat — mit 2 GB kommst du im Alltag hin, 4 GB sind komfortabler, gerade wenn die OCR mehrere Dokumente gleichzeitig kaut.

Beim Speicher kannst du entspannt bleiben. PDFs sind klein, ein gescanntes Dokument liegt bei ein bis drei Megabyte. Selbst wer jahrelang fleißig scannt, landet selten über ein paar Gigabyte — der Speicher wächst langsam und planbar. Eine SSD für Datenbank und Index ist trotzdem eine gute Idee, weil das Suche und Verarbeitung spürbar flotter macht.

Installation Schritt für Schritt

Der bequemste Weg ist das offizielle Installationsskript. Es fragt dich interaktiv nach den wichtigsten Einstellungen und legt dir eine fertige docker-compose.yml samt .env an. Auf deinem Server führst du dazu aus:

1. Installationsskript starten: bash -c "$(curl -L https://raw.githubusercontent.com/paperless-ngx/paperless-ngx/main/docs/setup.md)" — beziehungsweise den auf docs.paperless-ngx.com/setup dokumentierten Einzeiler. Das Skript fragt dich nach Zeitzone, OCR-Sprache, Ports und Verzeichnissen.
2. Bei der Sprachauswahl unbedingt deu für Deutsch wählen. Das setzt intern PAPERLESS_OCR_LANGUAGE=deu. Wenn du auch englische Dokumente hast, kannst du später deu+eng hinterlegen.
3. Zeitzone auf Europe/Berlin setzen, damit die Datumsangaben in den Dokumenten stimmen: PAPERLESS_TIME_ZONE=Europe/Berlin.
4. Einen sicheren PAPERLESS_SECRET_KEY vergeben — das Skript erzeugt in der Regel automatisch einen. Nutzt du das manuelle Setup, generierst du ihn mit openssl rand -base64 48 und trägst ihn in die .env ein.
5. Container hochfahren mit docker compose up -d. Beim ersten Start lädt Docker die Images, das dauert ein paar Minuten.
6. Einen Administrator anlegen: docker compose run --rm webserver createsuperuser. Hier vergibst du Benutzername und Passwort für die Weboberfläche.

Wer lieber alles selbst in der Hand hat, klont die Compose-Vorlagen direkt aus dem GitHub-Repository und passt .env und docker-compose.yml von Hand an. Das offizielle Repo liefert mehrere Varianten — etwa mit PostgreSQL (empfohlen) oder dem schlankeren SQLite. Für den produktiven Einsatz nimm PostgreSQL, das skaliert sauberer mit vielen Dokumenten. Danach erreichst du Paperless im Browser unter http://SERVER-IP:8000 und loggst dich mit deinem Superuser ein.

Praktisch: Wenn du deine Container ohnehin lieber grafisch verwaltest, lässt sich der ganze Stack auch bequem über Portainer deployen und im Blick behalten.

Dokumente reinbekommen — hier wird es interessant

Es gibt vier Wege, wie deine Dokumente in Paperless landen, und du wirst wahrscheinlich mehrere kombinieren.

Der Consume-Ordner ist der Klassiker. Du gibst das Verzeichnis per Samba-Freigabe im Netzwerk frei, und dein Scanner legt die Scans direkt dorthin ab. Paperless zieht sie automatisch ein. Kein Klicken, kein Hochladen — der Scan verschwindet aus dem Ordner und taucht Sekunden später fertig verschlagwortet in der Weboberfläche auf.

Der Weboberflächen-Upload ist für den schnellen Zwischendurch-Fall: PDF per Drag-and-drop ins Browserfenster ziehen, fertig. Praktisch für Dokumente, die eh schon digital vorliegen.

Über Mobile- und Scanner-Apps fotografierst du unterwegs einen Kassenbon oder ein Formular ab und schickst es direkt an Paperless. Es gibt dedizierte Apps, aber auch die Freigabe-Funktion vieler Scan-Apps auf dem Smartphone funktioniert.

Und jetzt das Feature, das die meisten unterschätzen: der E-Mail-Abruf per IMAP. Du legst in Paperless ein Mailkonto an, und das System holt sich automatisch die Anhänge aus deinem Postfach. Sämtliche digitalen Rechnungen — Amazon, Stromanbieter, Handyvertrag, die PDF vom Onlineshop — landen so vollautomatisch im Archiv, ohne dass du einen Finger rührst. Dabei helfen Regeln, etwa „hole alle Anhänge aus Mails mit dem Betreff Rechnung“ oder „nur von dieser Absenderadresse“. Genau das ist der Punkt, an dem Paperless vom Scan-Spielzeug zum echten Werkzeug wird.

Scanner-Praxis: Womit es wirklich Spaß macht

Ganz ehrlich: Ob Paperless zur täglichen Gewohnheit wird oder nach zwei Wochen einschläft, entscheidet die Hardware. Der Unterschied heißt Duplex-Dokumentenscanner mit Einzug. So ein Gerät zieht einen ganzen Stapel automatisch ein, scannt Vorder- und Rückseite in einem Rutsch und wirft eine fertige PDF aus. Mit der Funktion Scan-to-Folder legt er die Datei direkt in den Consume-Ordner — du legst den Poststapel ein, drückst einen Knopf und der Rest passiert von allein. Alternativ geht auch Scan-to-Mail an das IMAP-Postfach, das Paperless abfragt.

Ein normaler Multifunktionsdrucker mit Flachbett funktioniert auch, keine Frage. Aber Blatt für Blatt einzeln auflegen, Deckel zu, warten, umdrehen — das macht nach dem fünften Dokument keinen Spaß mehr, und genau daran scheitern die meisten papierlosen Vorsätze. Ein Einzugsscanner kostet einmalig etwas, zahlt sich aber in Nerven aus.

Ordnung schaffen: Tags, Korrespondenten und der Lerneffekt

Paperless bietet dir mehrere Ordnungsdimensionen, die du nicht alle gleichzeitig überfrachten solltest. Tags sind frei vergebbare Schlagworte — etwa „Steuer 2026″, „Auto“, „wichtig“. Korrespondenten sind die Gegenstellen: Absender oder Empfänger. Dokumenttypen beschreiben die Art: Rechnung, Vertrag, Bescheid, Kontoauszug. Und Speicherpfade bestimmen, wie Paperless die Archivdateien intern ablegt, falls du auch außerhalb der Weboberfläche geordnet zugreifen willst.

Mein Rat: Fang schlank an. Ein Dutzend Tags reicht am Anfang. Wichtig ist der Lerneffekt. Die ersten fünfzig Dokumente sortierst du weitgehend selbst — das ist Handarbeit und kostet einen Nachmittag. Danach hat der Klassifikator genug gesehen, um bei neuen Dokumenten Korrespondent, Typ und Tags korrekt vorzuschlagen. Ab da bestätigst du meistens nur noch mit einem Klick.

Ein Wort noch zu den ASN, den Archiv-Seriennummern. Das ist eine fortlaufende Nummer, die Paperless einem Dokument vergibt. Der Clou für alle, die das Papier trotzdem behalten: Du klebst einen Barcode-Aufkleber mit der ASN auf das physische Original und legst es einfach numerisch fortlaufend in einen Ordner. Suchst du später das Papier zu einem digitalen Dokument, zeigt dir Paperless die ASN, und du greifst blind in den richtigen Ordner. Kein thematisches Einsortieren mehr — die Ablage wird zur reinen Nummernfolge.

Wichtig: Backup nicht vergessen

Ein Archiv, das nur an einer Stelle liegt, ist kein Archiv, sondern eine Zeitbombe. Wenn deine gesamte Dokumentenverwaltung auf einem einzigen Server liegt und die Platte stirbt, sind Jahre an Scans weg. Deshalb: Backup von Anfang an mitdenken.

Paperless bringt dafür ein eigenes Werkzeug mit, den document_exporter. Er exportiert alle Dokumente, Metadaten und die Datenbankinhalte in ein sauberes, wieder importierbares Verzeichnis: docker compose exec webserver document_exporter ../export. Dieses Exportverzeichnis sicherst du dann nach der bewährten 3-2-1-Regel: drei Kopien, auf zwei verschiedenen Medien, davon eine an einem anderen Ort. Also zum Beispiel der Server selbst, eine externe Platte und ein verschlüsseltes Cloud- oder Offsite-Backup.

Und jetzt die ehrliche juristische Ansage: Ein digitales Archiv ersetzt nicht jedes Papier. Originale wichtiger Dokumente behältst du trotzdem. Urkunden, notarielle Verträge, Zeugnisse, handschriftlich unterschriebene Dokumente mit Beweiskraft — die gehören weiterhin im Original in einen Ordner oder besser in einen feuerfesten Dokumententresor. Paperless ist super für den schnellen Zugriff und die Suche, aber vor Gericht zählt bei manchen Papieren nun mal das Original mit Siegel.

Die Grenzen — ehrlich benannt

Paperless ist großartig, aber es ist kein Selbstläufer. Drei Dinge solltest du wissen, bevor du startest. Erstens: Die Ersteinrichtung und Einarbeitung kostet Zeit. Docker verstehen, Tags-Konzept aufsetzen, die ersten Dokumente durchsortieren — rechne mit ein, zwei Nachmittagen, bis es rund läuft. Zweitens: Es braucht Disziplin. Ein papierloses Büro funktioniert nur, wenn du eingehende Post auch tatsächlich scannst, statt den Stapel wieder wachsen zu lassen. Ein fester Rhythmus, etwa einmal die Woche, hilft. Drittens: Es ist dein Server, den du pflegen musst. Updates einspielen, Backups prüfen, ab und zu nach dem Rechten sehen. Das ist der Preis der Unabhängigkeit von der Cloud — dafür gehören dir deine Daten wirklich.

Troubleshooting: Die häufigsten Stolperfallen

Ein paar Probleme tauchen bei fast jedem am Anfang auf, deshalb hier die Klassiker samt Lösung.

• OCR erkennt keinen oder wirren Text: In neun von zehn Fällen steht die Sprache nicht auf Deutsch. Prüfe PAPERLESS_OCR_LANGUAGE=deu in der .env und starte die Container neu. Auch das passende Tesseract-Sprachpaket muss im Image vorhanden sein — bei den offiziellen Images ist Deutsch dabei.
• Dokumente im Consume-Ordner werden ignoriert: Meist sind es Dateiberechtigungen. Der Docker-Container braucht Lese- und Schreibrechte auf dem Ordner. Prüfe die PAPERLESS_USERMAP_UID und PAPERLESS_USERMAP_GID, damit sie zum Besitzer des Verzeichnisses passen.
• Duplikate: Paperless erkennt identische Dateien anhand einer Prüfsumme und weist sie ab. Lädst du dasselbe Dokument leicht verändert erneut hoch, kann es aber doppelt landen. Die Suche und ein regelmäßiger Blick in die neuesten Dokumente helfen beim Aufräumen.
• Verarbeitung quälend langsam: OCR ist rechenintensiv. Auf schwacher Hardware wie einem älteren Raspberry Pi dauert ein Dokument schon mal eine Minute. Reduziere die Zahl paralleler Worker, wenn der Server sonst in die Knie geht, oder gönn ihm mehr RAM und eine SSD.

Fazit

Paperless-ngx ist eines der Projekte, bei denen sich der anfängliche Aufwand handfest auszahlt. Nach der Einrichtung hast du ein durchsuchbares, selbst gehostetes Archiv, das dir jede Rechnung und jeden Vertrag in Sekunden liefert — ohne monatliches Abo und ohne dass deine sensiblen Unterlagen bei einem Cloud-Anbieter liegen. Der Einstieg über Docker Compose ist gut dokumentiert, der Lernalgorithmus nimmt dir nach den ersten Wochen die meiste Sortierarbeit ab, und der IMAP-Abruf sammelt deine digitalen Rechnungen von ganz allein ein. Wichtig bleibt: ein sauberes Backup nach der 3-2-1-Regel und die Disziplin, wirklich zu scannen. Wer das mitbringt und einen Duplex-Scanner danebenstellt, wälzt tatsächlich nie wieder einen Aktenordner. Wenn du ohnehin gerade deinen Homeserver ausbaust, passt Paperless perfekt neben Tools wie Immich für Fotos — beides Dienste, die dir ein Stück digitale Souveränität zurückgeben.

Häufige Fragen

Ist Paperless-ngx kostenlos?

Ja, Paperless-ngx ist freie Open-Source-Software unter der GPL und komplett kostenlos. Es fallen keine Lizenz- oder Abogebühren an. Kosten entstehen nur für die Hardware — Homeserver, NAS oder Raspberry Pi — und optional für einen Dokumentenscanner. Software-seitig zahlst du keinen Cent, und es gibt kein beschnittenes „Free“-Modell mit Bezahlschranke.

Läuft Paperless-ngx auf dem Raspberry Pi?

Ja, und sogar richtig gut. Ein Raspberry Pi 4 oder 5 mit ausreichend RAM ist eine beliebte, stromsparende Basis; auf dem Pi 5 mit 8 GB läuft die Verarbeitung flüssig. Die OCR ist rechenintensiv, deshalb solltest du eine SSD statt einer SD-Karte nutzen. Für den normalen Haushalt reicht die Leistung locker.

Welcher Scanner passt am besten?

Ein Duplex-Dokumentenscanner mit automatischem Einzug ist die klar beste Wahl. Er zieht ganze Stapel ein, scannt beide Seiten gleichzeitig und legt die Dateien per Scan-to-Folder direkt im Consume-Ordner ab. Achte auf Netzwerkfähigkeit per WLAN oder LAN. Ein Multifunktionsdrucker mit Flachbett geht auch, ist im Alltag aber deutlich mühsamer.

Sind meine Dokumente sicher?

Bei Paperless liegen deine Dokumente auf deiner eigenen Hardware statt in einer fremden Cloud — ein großer Vorteil für sensible Unterlagen. Für echte Sicherheit sorgst du selbst: ein starkes Passwort, kein ungeschützter Zugriff aus dem Internet und vor allem ein zuverlässiges Backup. Von unterwegs greifst du am besten über ein VPN zu statt über eine offene Portfreigabe.

Kann ich bestehende PDF-Sammlungen importieren?

Ja, das ist einer der großen Vorteile. Du kopierst deine vorhandenen PDFs einfach in den Consume-Ordner, und Paperless verarbeitet sie wie frische Scans — inklusive OCR, falls der Textlayer fehlt. Bei großen Sammlungen importierst du besser in Etappen, damit die Verarbeitung nicht überläuft. Danach lässt sich alles normal taggen und durchsuchen.