Software & Collaboration
Paperless-ngx
Paperless-ngx verwaltet digitale Dokumente auf dem eigenen Server. Es macht Scans durchsuchbar und hilft, Rechnungen, Verträge und Briefe zu ordnen und wiederzufinden.
- Digitaler Posteingang
- Durchsuchbare Scans
- Tags & Filter
- Gezielte Freigaben
- Betrieb auf eigenem Server
Paperless-ngx ist ein Dokumentenmanagementsystem, kurz DMS. Es verbindet Dateien mit ihrem Textinhalt und Angaben wie Absender, Dokumentdatum und Dokumenttyp. Damit lassen sich Unterlagen über ihren Inhalt finden, auch wenn ihr Dateiname wenig aussagt.
Ein Beispiel: Ein Unternehmen erhält eine Lieferantenrechnung als PDF per E-Mail und einen unterschriebenen Vertrag als Scan. Beide sollen später auffindbar sein. Die Buchhaltung braucht Zugriff auf die Rechnung, während der Vertrag nur für bestimmte Mitarbeitende sichtbar sein soll. An diesem Beispiel lässt sich erklären, was Paperless-ngx übernimmt und was eingerichtet oder geprüft werden muss.
1. Wie kommt die Rechnung ins System?
Für einen ersten Versuch genügt der Upload im Browser. Für wiederkehrende Eingänge lässt sich ein überwachter Ordner einrichten, der Consume-Ordner. Ein Scanner kann dort Dateien ablegen. Die Verbindung zwischen Scanner und Ablage muss separat eingerichtet werden, etwa über eine Dateifreigabe.
Nach erfolgreicher Übernahme liegen die Dateien im Dokumentenspeicher von Paperless-ngx und verschwinden aus dem Consume-Ordner. Dieser Ordner ist deshalb eine Eingangsstelle und keine zusätzliche Sicherung. Ob ein Einzug geklappt hat, lässt sich am verarbeiteten Dokument und am Status der Importaufgabe prüfen.
Für die Rechnung aus unserem Beispiel kann Paperless-ngx ein eingerichtetes E-Mail-Konto über IMAP abfragen. Eine Mailregel legt fest, welche Nachrichten und Anhänge übernommen werden. Sie kann anschließend zum Beispiel die Nachricht verschieben. Ein eigener Rechnungsordner im Postfach begrenzt den Einzug und erleichtert die Kontrolle.
2. Was Texterkennung und Archivkopie leisten
Ein Scan enthält zunächst ein Bild der Seite. Die optische Zeichenerkennung (OCR) versucht, daraus Buchstaben und Wörter zu gewinnen. So kann die Suche später auch den Lieferantennamen auf einer gescannten Rechnung finden. Ein direkt aus einer Anwendung erzeugtes PDF enthält häufig bereits Text, den Paperless-ngx ohne erneute OCR übernehmen kann.
Die Originaldatei, der für die Suche erfasste Text und eine zusätzliche Archivfassung haben unterschiedliche Aufgaben. Im geprüften Stand 3.2.1 kann Paperless-ngx eine PDF/A-Datei erzeugen. Dieses PDF-Format ist auf langfristige Darstellbarkeit ausgelegt. In der Standardeinstellung entsteht eine solche Fassung bei Scans und Bilddokumenten. Für digitale PDFs mit vorhandener Textebene wird sie normalerweise übersprungen. Die Erzeugung ist separat konfigurierbar.
Bei der normalen Übernahme bleibt das Original erhalten. Spätere PDF-Bearbeitungen, beispielsweise das Entfernen von Seiten, können dagegen die Originaldatei verändern und digitale Signaturen ungültig machen. PDF/A allein verhindert weder Bearbeitung noch Löschung.
Beim eingescannten Vertrag sind Sprache und Scanqualität entscheidend. Eine falsch erkannte Ziffer bleibt auch dann falsch, wenn der Text durchsuchbar ist. Für deutsche Dokumente muss die passende OCR-Sprache verfügbar und konfiguriert sein. Unleserliche Stellen sollte man anhand der Seite prüfen, bevor man erkannte Daten weiterverwendet.
3. Wie aus einer Datei ein auffindbarer Beleg wird
Ergänzende Angaben zu einem Dokument heißen Metadaten. Bei unserer Rechnung wäre der Lieferant der Korrespondent, also die zugeordnete Person oder Organisation. Der Dokumenttyp lautet „Rechnung“. Ein Tag ist ein frei vergebenes Schlagwort, etwa „Büroausstattung“. Mehrere Tags können dasselbe Dokument aus unterschiedlichen Blickwinkeln erschließen, ohne die Datei mehrfach abzulegen.
Später lässt sich die Rechnung über Lieferant, Dokumenttyp und Zeitraum eingrenzen. Ein Wort aus dem Inhalt verfeinert die Volltextsuche. Das Dokumentdatum beschreibt dabei das Ausstellungsdatum, das Hinzufügedatum den Eingang in Paperless-ngx. Diese Unterscheidung hilft, wenn ältere Unterlagen erst nachträglich eingescannt werden.
Zuordnungen lassen sich von Hand pflegen oder durch passende Suchregeln unterstützen. Der Abgleich „Auto“ lernt aus bereits zugeordneten Dokumenten. Er muss für die betreffenden Tags, Korrespondenten oder Dokumenttypen gewählt werden und kann falsche Zuordnungen erzeugen. Ein unbekannter Lieferant wird dadurch nicht automatisch zuverlässig erkannt.
Ein Workflow verbindet ein Ereignis mit Bedingungen und Aktionen. Beispielsweise kann eine eingerichtete Regel neue Belege mit dem Tag „Zu prüfen“ versehen und einer zuständigen Person zuordnen. Nach der Kontrolle entfernt diese das Tag. Benutzerdefinierte Felder können Rechnungsnummer oder Fälligkeit aufnehmen. Dass ein Feld vorhanden ist, bedeutet noch nicht, dass es automatisch und korrekt befüllt wird. Auch eine Zahlungsfreigabe oder Buchung folgt daraus nicht.
KI ist eine optionale Ergänzung
Version 3 unterstützt zusätzliche KI-Vorschläge, etwa für Titel und Zuordnungen. Dafür können lokale Modelle über Ollama oder externe Anbieter eingerichtet werden. Die Funktion muss aktiviert werden und übermittelt Dokumentinhalte an den konfigurierten Dienst. Vor dem Einsatz mit vertraulichen Unterlagen muss deshalb klar sein, wo dieser Dienst läuft und welche Daten er erhält. Suche und klassische Zuordnungsregeln benötigen diese KI-Anbindung nicht.
4. Wer darf Rechnung und Vertrag sehen?
Paperless-ngx unterscheidet allgemeine Benutzerrechte und Rechte an einzelnen Objekten. Ein Konto benötigt zunächst die allgemeine Berechtigung für eine Funktion. Der Eigentümer und die Freigaben am Dokument bestimmen zusätzlich, wer das konkrete Dokument sehen oder bearbeiten darf. Benutzergruppen erleichtern gemeinsame Freigaben, etwa für die Buchhaltung.
In unserem Beispiel erhält die Buchhaltungsgruppe Zugriff auf die Rechnung. Der vertrauliche Vertrag bekommt einen eigenen Eigentümer und Freigaben nur für die zuständigen Personen. Ein Tag „Vertraulich“ beschreibt den Inhalt, setzt aber für sich genommen keine Zugriffssperre.
Den Import mit einem normalen Benutzerkonto testen
Dokumente aus dem Consume-Ordner haben standardmäßig keinen Eigentümer. Eigentümerlose Dokumente sind laut Dokumentation für Benutzer mit den allgemeinen Dokumentrechten sichtbar. Ein Workflow kann Eigentümer und Freigaben gezielt setzen. Vor dem Einzug vertraulicher Unterlagen sollte deshalb ein Test mit einem gewöhnlichen Benutzerkonto zeigen, welche Dokumente tatsächlich sichtbar sind. Ein Administratorkonto eignet sich dafür nicht.
5. Was zum eigenen Betrieb und zur Sicherung gehört
Der dokumentierte Einstieg ist Docker Compose. Damit werden die Anwendung und ihre benötigten Dienste gemeinsam gestartet. Die Datenbank hält unter anderem Zuordnungen, Benutzer und Rechte. Ein Hintergrunddienst verarbeitet Einzüge und Texterkennung. Ein Redis-kompatibler Vermittlungsdienst koordiniert Aufgaben, in den aktuellen Compose-Dateien ist dafür Valkey vorgesehen. Für Office-Dokumente können Tika und Gotenberg als zusätzliche Verarbeitungsdienste hinzukommen.
Paperless-ngx verschlüsselt seine Dokumentablage nicht selbst. Wer Zugriff auf die gespeicherten Dateien oder ungeschützte Sicherungen hat, wird durch die Rechte der Weboberfläche nicht aufgehalten. Datenträgerverschlüsselung, abgesicherte Serverzugänge und geschützte Backups müssen außerhalb der Anwendung eingerichtet werden. Für den Zugriff über das Netz gehören HTTPS und ein bewusst gewählter Fernzugang dazu.
Eine Kopie der PDFs sichert die Zuordnungen und Freigaben nicht mit. Für Backup und Wiederherstellung müssen Dokumentdateien und Datenbank zusammenpassen. Der mitgelieferte Dokumentenexporter kann Dateien, Vorschaubilder und Datenbankinhalte einschließlich Metadaten exportieren. Die Betriebskonfiguration und benötigte Zugangsdaten gehören zusätzlich in die Sicherungsplanung. API-Zugangstoken sind im Export nicht enthalten.
Die Wiederherstellung aus einem Export erfolgt zunächst mit derselben Paperless-ngx-Version, die ihn erzeugt hat. Ein sinnvoller Test ist eine getrennte Installation: Export einspielen, die Beispielrechnung suchen, Original öffnen und die Sichtbarkeit des Vertrags mit einem normalen Konto prüfen. Erst dieser Versuch zeigt, ob sich der benötigte Bestand wieder nutzen lässt. Vor einem Versionswechsel gehören ein aktuelles Backup und die Hinweise zur jeweiligen Veröffentlichung dazu.
Anleitungen mit der eigenen Version abgleichen
Ältere Anleitungen können andere Voreinstellungen beschreiben, etwa beim Umgang mit Duplikaten oder bei Archivkopien. Vor dem Übernehmen einer Konfiguration den eigenen Versionsstand mit der zugehörigen Dokumentation abgleichen. Dieser Artikel beschreibt Version 3.2.1.
6. Was Archivierung im rechtlichen Sinn zusätzlich verlangt
Bei steuerlich relevanten Unterlagen betreffen die GoBD die ordnungsmäßige Führung und Aufbewahrung elektronischer Aufzeichnungen. Dazu gehören nachvollziehbare Abläufe, der Umgang mit Änderungen, geregelte Zugriffe und eine Verfahrensdokumentation. Ob ein konkretes Verfahren diese Anforderungen erfüllt, lässt sich nicht allein am Produktnamen entscheiden.
Paperless-ngx besitzt eine standardmäßig aktivierte Dokumentenhistorie, den Audit Trail. Sie protokolliert Änderungen. Zusätzlich können Dateiversionen frühere Dateistände verfügbar halten. Beides ist von einer technisch gegen Überschreiben oder Löschen geschützten Aufbewahrung zu unterscheiden. Wer umfassende Rechte auf Datenbank und Speicher besitzt, hat weitere Eingriffsmöglichkeiten als ein gewöhnlicher Benutzer der Anwendung.
Das Bundesfinanzministerium stellt klar, dass selbst Zertifikate oder Testate Dritter die Finanzbehörden bei der Beurteilung nicht binden. Ein fehlendes Zertifikat ist deshalb ebenso wenig ein pauschaler Gegenbeweis wie ein vorhandenes eine Garantie. Für die Rechnung aus unserem Beispiel müssen die tatsächlich eingesetzten technischen und organisatorischen Maßnahmen bewertet werden. Durchsuchbarkeit, PDF/A und Änderungsprotokoll allein belegen keine GoBD-konforme Aufbewahrung.
Bei strukturierten E-Rechnungen ist außerdem der maschinenlesbare Datenteil aufzubewahren. Eine bloße PDF-Ansicht oder ein Ausdruck ersetzt ihn nicht. Für solche Belege muss der gesamte Weg vom Empfang bis zur Sicherung die strukturierten Daten erhalten. Das ist eine andere Anforderung als die Texterkennung eines Scans.
7. Wo man bei fehlenden oder falschen Ergebnissen ansetzt
| Beobachtung | Sinnvoller erster Prüfschritt |
|---|---|
| Ein E-Mail-Anhang fehlt im Bestand | Kontoverbindung, gewählten Mailordner und Filter der Mailregel prüfen. Danach den Status der Importaufgabe ansehen. |
| Das Dokument ist da, die Suche findet ein Wort aber nicht | Den erfassten Text mit der sichtbaren Seite vergleichen. Bei einem Scan Sprache und Lesbarkeit prüfen, bei einem digitalen PDF dessen vorhandene Textebene. |
| Lieferant oder Dokumenttyp ist falsch | Die verwendete Zuordnungsregel und bereits zugeordnete Beispieldokumente kontrollieren. Die richtige Zuordnung am Beleg korrigieren. |
| Ein Kollege sieht zu viel oder zu wenig | Allgemeine Rechte, Eigentümer, Gruppenfreigaben und Import-Workflows zusammen prüfen. Mit dem betroffenen Konto testen. |
8. Stärken und Grenzen
| Stärken | Grenzen |
|---|---|
| Volltext und Metadaten erschließen Scans und digitale Dokumente gemeinsam. | Erkennungsfehler und unpassende Zuordnungen benötigen Kontrolle. |
| Regeln und Workflows unterstützen wiederkehrende Eingänge und Freigaben. | Ein Tag oder benutzerdefiniertes Feld bildet noch keinen vollständigen Freigabe- oder Buchhaltungsprozess ab. |
| Eigener Server und gezielte Benutzerfreigaben ermöglichen einen kontrollierten Datenzugang. | Server, Backups und optionale externe Dienste müssen in das Schutzkonzept einbezogen werden. |
| Offener Quellcode und Exportwerkzeuge erleichtern unabhängigen Betrieb und Datenübernahme. | Verfügbarkeit und Wiederherstellung hängen vom eingerichteten Betrieb ab. Aufbewahrungspflichten brauchen eine eigene Prüfung. |
Häufige Fragen zu Paperless-ngx
Ja, die Benutzeroberfläche ist auf Deutsch verfügbar. Die Sprache der Texterkennung wird davon unabhängig eingestellt. Für deutsche Scans lautet der OCR-Sprachcode deu, beispielsweise in PAPERLESS_OCR_LANGUAGE=deu. Dafür müssen die deutschen OCR-Sprachdaten vorhanden sein. Eine deutsche Oberfläche allein stellt die Texterkennung noch nicht auf Deutsch um.
Paperless-ngx ist die gemeinschaftlich gepflegte Weiterentwicklung von Paperless und paperless-ng. Der Quellcode steht unter der GPLv3, für die Software selbst fällt keine Lizenzgebühr an. Server, Datensicherung, Updates und Betreuung verursachen je nach Betrieb eigene Kosten.
Nein. Bereits digitale Unterlagen lassen sich im Browser hochladen oder über eingerichtete E-Mail-Regeln übernehmen. Ein Scanner wird erst für Papierunterlagen gebraucht. Ein Scan mit gut lesbarem Text erleichtert die spätere Texterkennung.
Seit Version 3.0 werden doppelte Dokumente standardmäßig angenommen. Optional kann PAPERLESS_CONSUMER_DELETE_DUPLICATES aktiviert werden. Dann erkennt Paperless-ngx Dateien mit identischem Hash und entfernt das Duplikat aus dem Consume-Ordner, ohne es erneut zu übernehmen. Ein neuer Scan derselben Papierrechnung kann andere Dateidaten haben und wird damit nicht zuverlässig als derselbe Beleg erkannt.
Quellen und Dokumentationsstand
Faktencheck vom 21. September 2026. Grundlage sind die offiziellen Releases und die Dokumentation zu Paperless-ngx 3.2.1. Das Beispiel mit Rechnung und Vertrag dient der Erklärung und beschreibt keine Kundeninstallation. Es wurde keine Paperless-Installation praktisch getestet.
- Offizielles Handbuch: Einzug, Metadaten und Berechtigungen
- Zuordnungsregeln und erweiterte Nutzung
- Konfiguration: OCR, Archivkopien und Duplikate
- Sprachen der Benutzeroberfläche im offiziellen Projekt
- Installation mit Docker Compose
- Administration: Export und Wiederherstellung
- Geprüfte Nutzungsdokumentation im Versionsstand 3.2.1
- Geprüfte Konfiguration im Versionsstand 3.2.1
- Veröffentlichungen und Änderungshinweise
- Projekt und GPLv3-Lizenz
- BMF: GoBD, insbesondere Randziffern 179 bis 181
- BMF: GoBD-Änderung 2025 zur Aufbewahrung von E-Rechnungen
Auch der Autor ist nur ein Mensch, dem Fehler unterlaufen können. Wenn in diesem Beitrag etwas nicht stimmt oder unklar ist, freuen wir uns über einen kurzen Hinweis über das Kontaktformular unten, wir prüfen und korrigieren das.
Der nächste Schritt
Fragen zu Ihrer Dokumentenablage?
Wir unterstützen Sie bei der Planung von Dokumenteneingang, Zugriffsrechten und einem Betrieb mit geprüfter Datensicherung.