Paperless-ngx: Definition und Einordnung 2026

Paperless-ngx ist ein Open Source Dokumentenmanagementsystem, das Papier in ein durchsuchbares digitales Archiv verwandelt. Die Software läuft auf dem eigenen Server, erkennt Text per OCR und sortiert Rechnungen, Verträge und Briefe automatisch nach Tags, Korrespondenten und Dokumenttypen.

Paperless-ngx ist der offizielle Nachfolger der Projekte Paperless und Paperless-ng. Statt eines einzelnen Maintainers trägt heute ein Community Team die Entwicklung. Der Code steht unter GPL-3.0 auf GitHub und zählt dort rund 45.000 Sterne. Technisch ist es eine Python Anwendung mit Django im Backend und Angular im Frontend.

Der Kern ist einfach: Dokument rein, Text erkannt, Metadaten gesetzt, sofort auffindbar. Die Daten liegen auf dem eigenen Server und werden laut Projekt nirgendwohin übertragen. Genau das macht Paperless-ngx interessant für alle, die digitale Souveränität ernst nehmen.

Aktuell ist Paperless-ngx 3.1.3 vom 4. September 2026. Die große Version 3.0 kam am 22. Juli 2026 und brachte eine eingebaute KI. Nicht verwechseln: Paperless.io aus Frankfurt ist ein anderes Produkt, eine Cloud Plattform für elektronische Signaturen.

Never Code Alone arbeitet aus Duisburg mit genau den Bausteinen, auf denen Paperless-ngx steht. Python mit Ruff, mypy und pytest. PostgreSQL und MariaDB. Docker für Deployments. Ollama für lokale KI Modelle. Alles auf eigenen Servern in Deutschland, mit Conversis als Infrastrukturpartner. Roland Golla arbeitet seit über 20 Jahren mit Open Source und weiß, wo Self Hosting im Alltag hakt: bei Updates, Backups und Zugriffsschutz.

Wir helfen Teams, Paperless-ngx sachlich einzuordnen und sicher zu betreiben. Dazu gehören Self Hosted KI mit DSGVO Anforderungen, der Betrieb eigener KI Assistenten ohne Cloud, die Ablösung von SaaS Tools durch eigene Plattformen und der Security Audit bestehender Setups. Für sensible Unterlagen passt unser Beitrag zu lokaler KI für Compliance und Berufsgeheimnis. Den Einstieg beschreibt unser Vibe Coding Consulting.

Paperless-ngx steuert keinen Scanner. Es verarbeitet, was ankommt. Dokumente landen auf drei Wegen im System: Der Scanner legt sie in einen überwachten Ordner, jemand zieht sie per Drag and Drop in den Browser, oder Paperless-ngx holt sie selbst aus Mail Postfächern ab.

Danach läuft die Pipeline automatisch:

• OCR: Die Open Source Engine Tesseract erkennt Text in über 100 Sprachen, auch bei reinen Bildscans.
• Archivformat: Paperless-ngx speichert eine PDF/A Version für die Langzeitarchivierung und behält das unveränderte Original.
• Zuordnung: Machine Learning setzt Tags, Korrespondenten und Dokumenttypen, Workflows lösen weitere Aktionen aus.
• Ablage: Die Dateien liegen als normale Dateien auf der Platte, Ordner und Dateinamen sind frei konfigurierbar.

Die Volltextsuche ist das eigentliche Argument. Sie schlägt Begriffe aus den eigenen Dokumenten vor, sortiert nach Relevanz, markiert Treffer und findet ähnliche Dokumente. Wer einmal die Stromrechnung von vor drei Jahren in Sekunden gefunden hat, will nicht zurück zum Aktenordner.

Für Teams gibt es ein Rechtesystem auf globaler Ebene und pro Dokument, eigene Felder mit verschiedenen Datentypen und Freigabelinks mit Ablaufdatum. Word, Excel und PowerPoint Dateien sowie Mails verarbeitet Paperless-ngx optional über Apache Tika. Wer Dokumentenprozesse darüber hinaus verbinden will, findet Ansätze bei der NCA KI Automatisierung.

Der einfachste Weg zu Paperless-ngx ist Docker Compose. Das Projekt liefert fertige Compose Dateien und ein Installationsskript, das die wichtigsten Fragen interaktiv stellt: Zeitzone, Datenbank, Office Support, Dokumentsprache. Grundlagen dazu erklärt unser Glossar Eintrag zu Docker.

Neben der Anwendung selbst braucht Paperless-ngx einen Message Broker. Redis oder das kompatible Valkey übernehmen geplante Aufgaben wie Mailabruf und Wartung. Bei der Datenbank gibt es drei Optionen. SQLite ist Standard und reicht für kleine Geräte wie einen Raspberry Pi. PostgreSQL empfiehlt das Projekt für Mehrbenutzerbetrieb und mehr Last. MariaDB geht auch, mit ein paar dokumentierten Einschränkungen.

Seit Version 3.0 muss die Engine für PostgreSQL und MariaDB ausdrücklich gesetzt werden. Früher hat Paperless-ngx sie aus dem Hostnamen abgeleitet:

Für den Zugriff von außen gehört ein Reverse Proxy mit TLS davor, etwa Caddy mit automatischem HTTPS. Wer mehrere Dienste auf einem Server verwaltet, schaut sich Coolify als Self hosted PaaS an. Wie wir Deployments mit Staging absichern, zeigt unsere CI CD Pipeline mit Docker.

Nach rund zweieinhalb Monaten Beta erschien Paperless-ngx 3.0 am 22. Juli 2026 als stabiles Release. Es ist das größte Update seit Jahren. Neu sind Paperless AI, OCR auf einem entfernten Dienst, Versionierung von Dokumenten, ein neues Suchbackend und ein überarbeitetes Tasksystem.

Neue Suche. Das alte Backend Whoosh ist raus, jetzt arbeitet Tantivy. Das Indexformat ist nicht kompatibel, deshalb baut Paperless-ngx den Suchindex beim ersten Start nach dem Upgrade automatisch neu. Gespeicherte Ansichten werden migriert. Anwender berichten von spürbar schnellerer Suche.

Breaking Changes. Die Datenbank Engine muss für PostgreSQL und MariaDB explizit gesetzt sein. Die Einstellung für den Barcode Scanner ist entfallen, zxing-cpp ist das einzige Backend. Wer von einer älteren 2.x Version kommt, geht laut Community Berichten zuerst auf 2.20.15 und erst dann auf 3.x. Vor dem Upgrade gehört ein Backup über den Document Exporter dazu.

Seitdem folgen Patchreleases im Wochentakt. Version 3.1.2 schloss eine Sicherheitslücke, 3.1.3 vom 4. September 2026 bringt Bugfixes und weitere Härtung. Die Lehre für den Betrieb: Updates regelmäßig einspielen, nicht nur einmal im Jahr. Wie man so etwas absichert, beschreibt unser Beitrag zum Deployment vom Prototyp zur Live Anwendung.

Seit Version 3.0 bringt Paperless-ngx eine eigene KI mit. Sie schlägt Titel, Korrespondenten, Dokumenttypen und Tags vor und beantwortet im Chat Fragen zu einzelnen Dokumenten, etwa zur Kündigungsfrist in einem Vertrag. Die Funktion ist ab Werk ausgeschaltet. Ein Sprachmodell liefert Paperless-ngx nicht mit, es muss angebunden werden.

Als Backend gehen eine OpenAI kompatible API oder Ollama auf dem eigenen Server. Für den Dokumenten Chat braucht es zusätzlich ein Embedding Modell, bei Ollama ist embeddinggemma voreingestellt. Die Vorschläge funktionieren auch ohne Embeddings, dann betrachtet die KI nur das aktuelle Dokument.

Die Wahl des Backends ist eine Datenschutzfrage. Wer eine Cloud API nutzt, schickt den erkannten Text seiner Rechnungen und Verträge an einen Dritten. Mit Ollama bleibt alles im eigenen Netz. Welche lokalen Modelle sich eignen, zeigt unsere Übersicht der Ollama Modelle 2026. Für Unternehmen, die gehostete Inferenz mit DSGVO Absicherung brauchen, ist Conversis die Enterprise Option.

Neben der eingebauten KI gibt es Zusatzprojekte aus der Community, etwa paperless-gpt für automatisches Tagging und OCR mit Vision Modellen oder das gleichnamige, aber separate paperless-ai. Zwei Punkte aus der Praxis: Kleine lokale Modelle erfinden gern Korrespondenten, die im Dokument nicht vorkommen. Und manche Zusatzoberflächen haben keinen eigenen Login, halten aber einen Admin Token. Die gehören hinter eine Authentifizierung.

Das Projekt sagt es selbst deutlich: Paperless-ngx speichert Informationen im Klartext ohne Verschlüsselung und gehört nie auf einen Host, dem man nicht vertraut. Am sichersten läuft es auf einem lokalen Server mit funktionierenden Backups. Für den Betrieb heißt das: verschlüsselte Datenträger, Zugriff nur über VPN oder Reverse Proxy mit TLS, starke Passwörter und regelmäßige Exporte.

Self Hosting löst die DSGVO Frage nicht automatisch, verschiebt sie aber in die eigene Hand. Wer Paperless-ngx betreibt, entscheidet über Serverstandort, Zugriffe und Löschfristen selbst. Die Verantwortung dafür auch. Unsere Datenschutz und DSGVO Beratung setzt genau hier an.

Paperless-ngx ist geeignet für Freiberufler, kleine Büros, Teams mit viel Belegverkehr und alle, die ihren privaten Papierberg digitalisieren wollen. Es hat Stärken bei Suche, Automatisierung und Kontrolle über die eigenen Daten.

Weniger geeignet ist es, wenn niemand im Team einen Server pflegen will oder wenn zertifizierte Revisionssicherheit von Haus aus gefordert ist. Mit einer GoBD Zertifizierung wirbt das Projekt nicht, ob ein Setup die Anforderungen erfüllt, hängt vom Betrieb ab und gehört mit dem Steuerberater geklärt. Für Verträge mit elektronischer Signatur ist Paperless-ngx ebenfalls nicht gebaut.

Never Code Alone betreibt den eigenen Stack nach den Regeln, die Paperless-ngx für Dokumente vorgibt. Server in Deutschland, PostgreSQL und MariaDB im eigenen Haus, Ollama und OpenCode für KI Aufgaben, keine US Anbieter für eigene Produkte. Wo bei solchen Setups die Arbeit anfällt, wissen wir aus dem Alltag.

Typische Fragen aus der Praxis: Wie prüft man ein Open Source Projekt nüchtern? Wie sichert man Updates ab, bevor sie live gehen? Wie hält man Python Code sauber, wenn Erweiterungen dazukommen? Antworten liefern wir über Codebase Audits, unseren Guide zu Python Refactoring und Qualität und automatisierte Tests mit Cypress.

Paperless-ngx passt in eine Reihe souveräner Alternativen, die wir im Glossar einordnen: openDesk als Alternative zu Microsoft 365, Logseq für Wissensmanagement, Open Notebook als NotebookLM Alternative und Open WebUI als Oberfläche für lokale Modelle.

Ergänzend: Project NOMAD als Offline Knowledge Server und Fossify für datenschutzfreundliche Android Apps. Wer aus einem eigenen Prototyp ein tragfähiges System machen will, findet den Weg unter Vibe Coding Hilfe vom Prototyp zur Produktion.

Die wichtigsten Fragen zu Paperless-ngx, zu Version 3, zur Datenbankwahl, zur eingebauten KI und zum sicheren Betrieb. Stand September 2026.