
Paperless-ngx: Dein Weg zum papierlosen Büro
Paperless-ngx auf Deutsch einrichten: Installation auf Synology NAS, VPS und Homeserver, dazu Kosten, Hardware, Workflows, Scanner, Apps, GoBD und Alternativen.
Paperless-ngx ist eine Dokumentenverwaltung (DMS) zum Selbsthosten und der Weg zum papierlosen Büro. Du kannst Dokumente digitalisieren: Briefe, Rechnungen und Verträge lädst du hoch oder scannst sie direkt hinein. Paperless erkennt den Text per OCR (Tesseract), ordnet Korrespondent, Dokumententypen und Tags zu, archiviert alles und macht es durchsuchbar. Die Software ist Open Source und kostenlos.
Dieser Guide ist die zentrale Anlaufstelle zu allen Beiträgen rund um Paperless-ngx. Er beantwortet die Fragen vor der Installation (Kosten, Hardware, Plattform) und verweist danach auf die Anleitungen für Installation, Konfiguration, Ablage, Workflows und Scanner. Wenn du Paperless-ngx einrichten willst, findest du hier den richtigen Einstieg.

Was ist Paperless-ngx?
Die Geschichte ist eine typische Open-Source-Geschichte. Am 1. Januar 2017 veröffentlichte Daniel Quinn die erste Version von “Paperless”, weil er nicht mehr in staubigen Ordnern suchen wollte. Anfang 2019 beendete er die Entwicklung. Jonas Winkler führte das Projekt als Paperless-ng weiter (“NG” steht für Angular und “next-gen”). Als auch dieses Projekt 2021 nicht mehr gepflegt wurde, entstand 2022 die Community-Fork Paperless-ngx. Sie hat sich durchgesetzt und wird bis heute aktiv weiterentwickelt.
Das macht Paperless-ngx:
- OCR: Macht gescannte Dokumente und Bilder durchsuchbar. Das Original bleibt erhalten, zusätzlich entsteht eine PDF/A-Archivversion.
- Metadaten und Tagging: Korrespondent, Dokumenttyp, Datum, Tags und Zusatzfelder. Paperless lernt aus bereits einsortierten Dokumenten und schlägt Zuordnungen vor.
- Volltextsuche mit Filtern und gespeicherten Ansichten. Die Suchfunktion durchsucht auch den erkannten Text.
- Automatischer Import aus einem Ordner, aus E-Mail-Postfächern oder per Upload und API.
- Office-Dokumente und E-Mails mit Tika und Gotenberg zusätzlich zu PDFs und Bildern.
- Workflows, die neue Dokumente automatisch taggen, sortieren und weiterleiten. So kannst du das Einsortieren automatisieren.
- Mehrere Benutzer mit Rechten pro Dokument. Wie du Paperless in der Familie einrichtest, steht in Paperless-ngx in der Familie nutzen.
- KI-Funktionen ab Version 3: Metadaten-Vorschläge, Dokumenten-Chat und Suche über ein Sprachmodell, wenn du einen Anbieter anbindest, zum Beispiel ein lokales Modell über Ollama. Sie sind optional und standardmäßig aus.
Kosten
Die Software kostet nichts. Zahlen musst du für den Ort, an dem sie läuft. Drei typische Varianten:
| Variante | Laufende Kosten | Einmalig |
|---|---|---|
| VPS bei einem Anbieter | Server und Domain | keine |
| Eigenes NAS oder Homeserver | Strom | Gerät und Festplatten |
| Cloud-DMS-Abo | Abo pro Monat | keine |
Ein Rechenbeispiel für den VPS: Der Hetzner-Server CAX11 mit 2 Kernen und 4 GB RAM kostet laut Preisliste (Stand November 2026) 7,13 Euro brutto im Monat, also rund 86 Euro im Jahr. Die IPv4-Adresse und eine Domain (grob 10 bis 15 Euro im Jahr, je nach Endung) kommen hinzu. Prüfe die aktuelle Preisliste des Anbieters. Eine Alternative ist ein VPS bei netcup (Affiliate-Link).
Ein Rechenbeispiel für ein NAS: Läuft ein Gerät mit durchschnittlich 25 Watt rund um die Uhr, sind das etwa 219 Kilowattstunden im Jahr. Bei 0,30 Euro pro Kilowattstunde entspricht das rund 66 Euro Strom. Dazu kommt der Kaufpreis für Gerät und Festplatten.
Ein Backup auf einem zweiten Speicherort kommt in jedem Fall dazu. Es darf nicht auf demselben Gerät liegen.
Hardware
Messwerte aus meiner Installation mit PostgreSQL, Valkey, Tika, Gotenberg und Caddy auf einem Debian-13-Server: Im Leerlauf belegt der Stack rund 1,2 GB Arbeitsspeicher. Den größten Teil macht Paperless selbst (rund 730 MB) und Tika (rund 270 MB) aus.
- RAM: 2 GB sind das Minimum, 4 GB laufen komfortabel. Ohne Tika und Gotenberg sparst du rund 300 MB.
- CPU: Die Texterkennung nutzt den Prozessor. Zwei Kerne reichen, ein größerer Stapel dauert dann einfach länger.
- Speicher: Ein Export von zwölf Beispieldokumenten braucht rund 640 KB. Rechne bei normalen Scans mit 100 bis 300 KB pro Seite und plane Originale plus Archivversion ein. Eine SSD ist schneller als eine Festplatte, aber nicht nötig.
- Raspberry Pi: Läuft mit 64-Bit-System ab dem Pi 4. Die Homeserver-Anleitung nennt Einstellungen für schwache Geräte.
Plattform wählen und installieren
| Plattform | Passt, wenn | Anleitung |
|---|---|---|
| VPS | du von überall zugreifen willst und etwas Linux kannst | Paperless-ngx auf einem VPS installieren |
| Synology NAS | du bereits eins besitzt und Docker (Container Manager) mit Portainer nutzt | Paperless-ngx auf dem Synology NAS installieren |
| Homeserver, Mini-PC, Raspberry Pi | du es im Heimnetz betreiben willst | Paperless-ngx auf dem Homeserver |
| Andere NAS (QNAP, Ugreen) | das NAS Docker unterstützt | Die Synology-Anleitung dient als Vorlage, Ordner und Benutzer unterscheiden sich |
Das Einrichten klappt auf jeder Plattform mit Docker. Alle Anleitungen nutzen Docker Compose mit PostgreSQL und Valkey in Docker-Containern. Ich empfehle das Synology NAS, wenn du eins besitzt, weil es wenig Strom braucht und die Dokumente im Heimnetz bleiben. Ohne NAS ist ein VPS der einfachste Weg, und auch eine Proxmox-VM funktioniert. Für Tika und Gotenberg gilt: Du brauchst sie nur, wenn du mehr als PDFs und Bilder ablegen willst.
Dokumentenablage
In Paperless kannst du Dokumente verwalten und archivieren, und du ordnest sie mit fünf Mitteln. Wie du sie einsetzt, entscheidet über die spätere Übersicht:
- Korrespondent: Absender oder Empfänger, zum Beispiel dein Stromanbieter.
- Dokumenttyp: Rechnung, Vertrag, Bescheid, Kontoauszug. Die Dokumententypen legst du selbst an.
- Tags: Alles, was quer liegt, etwa “Steuer absetzbar” oder “Frist prüfen”.
- Speicherpfad: Bestimmt, wo die Datei auf der Festplatte liegt.
- Zusatzfelder: Eigene Felder wie Betrag oder Vertragsnummer.
Mein Rat: Wenige Dokumenttypen, wenige Tags, dafür saubere Korrespondenten. Die Volltextsuche findet den Rest und du kannst alle Dokumente schnell durchsuchen. Die Ordnerstruktur auf dem Server legst du mit Speicherpfaden an, wie Paperless-ngx: Speicherpfade und Ordnerstruktur es Schritt für Schritt zeigt. Das lohnt sich, bevor du Hunderte Dokumente importierst.
Workflows
Workflows ersetzen das manuelle Einsortieren. Du legst Auslöser und Aktionen fest: Passt ein Dokument zu einem Dateinamen, einer Quelle oder Wörtern im Text, setzt Paperless Tags, Typ, Korrespondent und Speicherpfad. Auch E-Mail-Versand und Webhooks sind möglich. Vier fertige Beispiele und die Stolperfallen stehen in Paperless-ngx Workflows.
Scanner und Apps
Scanner: Am elegantesten ist ein Netzwerkscanner, der in einen Ordner im Netz speichert. Der Ordner consume ist dafür der Eingang. Mit Samba gibst du ihn frei, mit Unterordnern vergibst du Tags schon beim Scannen, und mit Trennblättern zerlegst du einen Stapel in einzelne Dokumente. Die Einrichtung steht in Paperless-ngx: Scanner einrichten. Als reinen Dokumentenscanner empfehle ich den Brother ADS-1700W (Amazon Affiliate-Link).
Apps: Unterwegs lädst du Dokumente per Handy-App hoch. Die Paperless-Entwickler führen im Wiki eine Liste von Projekten. Beispiele:
- Android: Paperless Mobile, Paperless NGX Uploader, Waraq.
- iOS: Swift Paperless, Less Paper, QuickScan.
Die Apps sind Projekte Dritter. Prüfe vor dem Einsatz, wie aktuell sie sind und ob sie Paperless 3 unterstützen.
GoBD, DSGVO und Aufbewahrungsfristen
Dieser Abschnitt ist keine Rechtsberatung. Bei geschäftlicher Nutzung klärst du die Details mit deinem Steuerberater.
Aufbewahrungsfristen (Unternehmen): Seit dem 1. Januar 2025 gelten durch das Vierte Bürokratieentlastungsgesetz diese Fristen nach Handelsgesetzbuch und Abgabenordnung:
| Unterlagen | Frist |
|---|---|
| Buchungsbelege (Rechnungen, Kontoauszüge, Quittungen) | 8 Jahre |
| Handels- und Geschäftsbriefe ohne Belegfunktion | 6 Jahre |
| Bücher, Inventare, Jahresabschlüsse | 10 Jahre |
Die Frist beginnt mit dem Ende des Kalenderjahres, in dem das Dokument entstanden oder eingegangen ist. Für Banken, Versicherungen und Wertpapierinstitute gelten abweichende Regeln.
Aufbewahrungsfristen (privat): Gesetzlich gibt es wenige feste Fristen. Hilfreich als Faustregel: Rechnungen für Handwerkerleistungen am Grundstück zwei Jahre, Kaufbelege mindestens so lange wie die Gewährleistung, Verträge solange sie laufen, Steuerbescheide und Belege mindestens, bis der Bescheid bestandskräftig ist. Rentenunterlagen, Zeugnisse und Urkunden hebst du dauerhaft auf.
GoBD: Die Grundsätze zur ordnungsmäßigen Führung und Aufbewahrung von Büchern verlangen, dass elektronische Belege unveränderbar und nachvollziehbar aufbewahrt werden. Paperless-ngx erzwingt das nicht. Wer die Rechte hat, kann Metadaten ändern und Dokumente löschen, und der Administrator kommt an Datenbank und Dateien. Die Software ist nicht als GoBD-konform zertifiziert. Unveränderbarkeit stellst du deshalb über Maßnahmen her:
- Rechte: Alltagsbenutzer bekommen nur Ansehen und Hinzufügen, kein Ändern und Löschen. Das Administratorkonto nutzt du nur für die Verwaltung.
- Protokoll: Das Audit-Log von Paperless (standardmäßig an) hält Änderungen an Dokumenten, Dokumenttypen, Korrespondenten und Tags fest. Lass es aktiviert. Gelöschte Dokumente liegen zunächst im Papierkorb.
- Prüfsummen: Paperless speichert für jede Datei eine Prüfsumme, und der Sanity-Checker meldet Abweichungen. Das erkennt beschädigte Dateien, schützt aber nicht vor jemandem mit Zugriff auf die Datenbank.
- Unveränderlicher Speicher: Exportiere regelmäßig in ein Ziel, in dem Dateien nachträglich weder überschrieben noch gelöscht werden können, etwa S3-kompatibler Speicher mit Object Lock oder ein Borg-Repository im Append-only-Modus. Bewahre die Exporte so lange auf wie die Frist.
- Verfahrensdokumentation: Beschreibe, wie Belege eingehen, geprüft und abgelegt werden und wer Zugriff hat. Beim ersetzenden Scannen dokumentierst du außerdem, wann das Papier vernichtet wird.
Für steuerrelevante Unterlagen in einem Unternehmen klärst du mit dem Steuerberater, ob diese Maßnahmen genügen oder ein zertifiziertes Archivsystem nötig ist.
DSGVO: Betreibst du Paperless privat für dich, greift die Haushaltsausnahme. Nutzt du es geschäftlich oder für Dritte, bist du Verantwortlicher. Dann gilt:
- Schließe mit deinem Hosting-Anbieter einen Vertrag zur Auftragsverarbeitung ab. Große Anbieter stellen ihn bereit.
- Verschlüssele die Verbindung (HTTPS) und, wo möglich, die Festplatte.
- Vergib Rechte pro Benutzer und aktiviere die Zwei-Faktor-Anmeldung.
- Lege fest, wann du Dokumente löschst.
- Binde KI-Funktionen nur an, wenn du weißt, wohin Daten gesendet werden. Ein lokales Modell lässt Dokumente auf deinem Server.
Sicherheit, Backup und Updates
- Zugriff: HTTPS über einen Reverse Proxy wie Caddy, starke Passwörter, Zwei-Faktor und die Firewall deines Anbieters. Wer Paperless nur selbst nutzt, kann es hinter einem VPN verstecken.
- Backup: Backups sind unverzichtbar. Der eingebaute Exporter schreibt Dokumente und Metadaten in den Ordner
export. Sichere ihn auf ein zweites Gerät und teste die Wiederherstellung. Mehr in Paperless Backup und Restore und im Ofelia-Backup. - Updates: Zum Aktualisieren ziehst du neue Images. Mit festen Image-Tags wie
3.4bekommst du alle Patch-Versionen automatisch. Lies vor einer neuen Reihe die Release Notes. Die PostgreSQL-Hauptversion ersetzt du nie nur im Tag, sondern nach dieser Anleitung.
Alternativen
Paperless-ngx ist nicht für jeden die beste Wahl. Diese Projekte gehen andere Wege:
| Software | Kurz gesagt |
|---|---|
| Docspell | Open-Source-DMS mit Fokus auf automatische Erkennung und E-Mail-Import. |
| Mayan EDMS | Umfangreiches Dokumentenmanagement mit Workflows, eher für Organisationen. |
| Teedy | Schlankes DMS mit Weboberfläche, Tags und Volltextsuche. |
| Nextcloud mit Erkennungs-Apps | Wenn du ohnehin eine Nextcloud betreibst und Dateien statt eines DMS brauchst. |
| Bezahlte Cloud-DMS | Weniger Aufwand, aber du gibst Daten und Kontrolle ab. |
Ich bleibe bei Paperless-ngx, weil die Community groß ist, die Updates regelmäßig kommen und die Dateien als normale PDFs in einem Ordner liegen. Du bist also nicht gebunden.
Häufige Fragen (FAQ)
- Ist Paperless-ngx wirklich kostenlos? Ja, die Software ist Open Source. Kosten entstehen für Server oder Hardware, Strom, Domain und ein Backup.
- Wie viel RAM braucht Paperless-ngx? Der Stack mit Datenbank, Valkey, Tika und Gotenberg belegt im Leerlauf rund 1,2 GB. Plane 4 GB ein, mindestens 2 GB.
- Läuft Paperless-ngx auf dem Raspberry Pi? Ja, ab dem Raspberry Pi 4 mit 64-Bit-System. Reduziere die Zahl der Arbeiter und nutze eine SSD.
- Ist Paperless-ngx GoBD-konform? Nicht von Haus aus. Paperless erzwingt die Unveränderbarkeit nicht, und die Software ist nicht zertifiziert. Mit eingeschränkten Rechten, Audit-Log, unveränderlichem Backup und Verfahrensdokumentation kannst du die Anforderungen unterstützen. Kläre das mit deinem Steuerberater.
- Wie lange muss ich Rechnungen aufbewahren? Unternehmen bewahren Buchungsbelege seit 2025 acht Jahre auf, Handelsbriefe sechs Jahre. Privat gelten wenige feste Fristen.
- Wie sicher sind meine Daten? Das hängt von deiner Einrichtung ab: HTTPS, Zwei-Faktor, Firewall, Updates und ein getestetes Backup sind die wichtigsten Bausteine.
- Kann ich Dokumente wieder exportieren?
Ja. Der Document Exporter schreibt Originale und Metadaten, und im Ordner
medialiegen die Dateien als normale PDFs. - Welche Scanner funktionieren gut? Scanner mit Funktion Scan to SMB oder Scan to Folder. Wie du sie einrichtest, steht in der Scanner-Anleitung.
- Gibt es Apps für Paperless-ngx? Ja, für Android und iOS, zum Beispiel Paperless Mobile und Swift Paperless.
- Kann ich Paperless-ngx mit KI nutzen? Ab Version 3 gibt es eingebaute KI-Funktionen, die du mit einem Sprachmodell verbindest. Sie sind standardmäßig aus.
Als Amazon-Partner verdiene ich an qualifizierten Verkäufen.
Passende Blogbeiträge für Paperless-ngx Guide: Installation auf Synology, VPS und Homeserver
Paperless-ngx in der Familie nutzen: Benutzer, Gruppen und Rechte
Paperless-ngx für mehrere Personen einrichten: eigene Konten, private und gemeinsame Dokumente, Gruppen, Rechte, Postfach pro Person und Zwei-Faktor-Anmeldung.
Paperless-ngx auf einem VPS installieren: Docker, Caddy und Valkey
Paperless-ngx 3 auf einem Debian-13-VPS installieren: Docker Compose mit PostgreSQL, Valkey und Tika, HTTPS über Caddy, Backup und Update, Schritt für Schritt.
Paperless-ngx: Scanner einrichten mit Samba, Barcodes und App
Dokumente in Paperless-ngx scannen: Consume-Ordner per Samba freigeben, Unterordner als Tags nutzen, Stapel mit Barcodes trennen und per App hochladen.
Paperless-ngx: Speicherpfade und Ordnerstruktur einrichten
Paperless-ngx legt Dokumente standardmäßig als 0000001.pdf ab. So bekommst du lesbare Dateinamen und Ordner mit Speicherpfaden, Platzhaltern und document_renamer.
Paperless-ngx auf dem Synology NAS installieren: Docker und Portainer
Paperless-ngx 3 auf dem Synology NAS installieren: Docker Compose in Portainer mit PostgreSQL, Valkey und Tika, Ordnerrechte und Scanner-Inbox, Schritt für Schritt.
Paperless-ngx Workflows: Dokumente automatisch sortieren
Paperless-ngx Workflows weisen Tags, Dokumenttypen, Korrespondenten und Speicherpfade automatisch zu. Auslöser, Aktionen und vier fertige Beispiele.
Paperless-ngx auf dem Homeserver installieren: Docker Compose Anleitung
Paperless-ngx 3 auf Homeserver, Mini-PC oder Raspberry Pi mit Docker Compose installieren, mit PostgreSQL, Valkey und Tika. Anleitung für das lokale Netzwerk.
Paperless-ngx Backup & Restore: Die richtige Strategie
Erstelle ein sicheres, inkrementelles Paperless-ngx Backup mit Docker und stelle deine Dokumente im Notfall wieder her. Mit Anleitung für PostgreSQL und MariaDB, Schritt für Schritt erklärt.
Paperless-ngx: PostgreSQL auf Version 18 aktualisieren
Paperless-ngx mit Docker auf PostgreSQL 18 umstellen, zum Beispiel von Version 13 oder 14: Dump erstellen, Datenpfad anpassen, Daten zurückspielen und danach auf Paperless 3 updaten.
Paperless-ngx: Automatisches Docker-Backup mit Ofelia
Richte ein automatisches Backup für Paperless-ngx direkt im Docker-Stack mit Ofelia ein. Setze deine Cronjobs zuverlässig um – ganz ohne externen Server.