Paperless-ngx: Dokumentenmanagement selbst hosten – Setup-Guide 2026 | TYPONiels Blog

Paperless-ngx: Digitales Dokumentenmanagement selbst hosten – Setup-Guide 2026

Physische Dokumente scannen, digital archivieren und per Volltextsuche in Sekunden wiederfinden — das ist die Kernidee hinter Paperless-ngx. Als direkter Nachfolger von Paperless-ng ist es das meistgenutzte Self-Hosted-Dokumentenmanagementsystem in der Open-Source-Community.

In diesem Guide zeige ich, wie ich Paperless-ngx auf einem Kubernetes-Cluster eingerichtet habe, was die wichtigsten Features sind und warum es keine proprietäre Alternative braucht.

Was ist Paperless-ngx?

Paperless-ngx ist ein quelloffenes, selbst gehostetes Dokumentenmanagementsystem (DMS). Es nimmt Dokumente entgegen (per Upload, E-Mail oder Beobachten eines Ordners), extrahiert Text via OCR (Texterkennung), indiziert ihn für die Suche und stellt alles in einer modernen Web-Oberfläche bereit.

Kern-Features:

OCR via Tesseract (50+ Sprachen)
Automatische Dokumentenklassifikation per Machine Learning
Volltext-Suchmaschinein in Echtzeit (Whoosh)
Tags, Korrespondenten, Dokumententypen, Kabinette
Automatische Regeln für Zuweisung von Metadaten
REST-API für Drittanbieter-Integration
IMAP/E-Mail-Import, Watchfolder-Support
Mehrbenutzer-Support mit Berechtigungen
Docker-basiert, einfaches Setup

Warum Paperless-ngx? Es ist der Community-Fork von Paperless-ng (das selbst ein Fork von Paperless war) und wird aktiv weiterentwickelt. Es gibt keine versteckten Kosten, keine Cloud-Pflicht und keine Datenschutzprobleme.

Vergleich: Paperless-ngx vs. kommerzielle Alternativen

Feature	Paperless-ngx	DocuWare	M-Files
Kosten	Kostenlos	€€€€	€€€€
Self-Hosted	✅	❌	Optional
OCR	✅ Tesseract	✅	✅
KI-Klassifikation	✅ (lokal)	✅	✅
REST-API	✅	✅	✅
Datenschutz	100% lokal	Cloud	Cloud/On-Premise
DSGVO-konform	✅ einfach	✅ komplex	✅ komplex

Für Privatpersonen und kleine Unternehmen gibt es keinen Grund, für Dokumentenmanagement zu zahlen, wenn Paperless-ngx alles bietet.

Installation mit Docker Compose

Das einfachste Setup für eine einzelne Maschine:

version: "3.4"
services:
  broker:
    image: docker.io/library/redis:7
    restart: unless-stopped
    volumes:
      - redisdata:/data

  db:
    image: docker.io/library/postgres:16
    restart: unless-stopped
    volumes:
      - pgdata:/var/lib/postgresql/data
    environment:
      POSTGRES_DB: paperless
      POSTGRES_USER: paperless
      POSTGRES_PASSWORD: paperless

  webserver:
    image: ghcr.io/paperless-ngx/paperless-ngx:latest
    restart: unless-stopped
    depends_on:
      - db
      - broker
    ports:
      - "8000:8000"
    volumes:
      - data:/usr/src/paperless/data
      - media:/usr/src/paperless/media
      - ./export:/usr/src/paperless/export
      - ./consume:/usr/src/paperless/consume
    environment:
      PAPERLESS_REDIS: redis://broker:6379
      PAPERLESS_DBHOST: db
      PAPERLESS_URL: https://paperless.example.com
      PAPERLESS_SECRET_KEY: "dein-geheimer-schlüssel"
      PAPERLESS_TIME_ZONE: Europe/Berlin
      PAPERLESS_OCR_LANGUAGE: deu+eng
      PAPERLESS_TIKA_ENABLED: 1

volumes:
  data:
  media:
  pgdata:
  redisdata:

Nach dem Start: docker compose run --rm webserver createsuperuser

Automatische Dokumentenklassifikation einrichten

Die Killer-Feature von Paperless-ngx ist die automatische Klassifikation. Sobald du genug Dokumente getaggt hast (ca. 20–30 pro Kategorie), lernt das System eigenständig:

Trainieren: Dokumente manuell taggen, Korrespondenten zuweisen, Typen setzen
Warten: Das System trainiert beim Speichern automatisch im Hintergrund
Überprüfen: Bei neuen Dokumenten werden Vorschläge mit Konfidenz-Prozent angezeigt
Automatisieren: In den Einstellungen "Auto-Training" aktivieren

In der Praxis erkennt Paperless-ngx nach einigen Wochen Briefe von der Krankenkasse, Steuerbelege und Rechnungen zuverlässig — ohne weitere Eingriffe.

E-Mail-Import automatisieren

Paperless-ngx kann ein IMAP-Postfach überwachen und Anhänge automatisch importieren:

# In docker-compose.yml, webserver environment:
PAPERLESS_EMAIL_HOST: mail.example.com
PAPERLESS_EMAIL_PORT: 993
PAPERLESS_EMAIL_USER: paperless@example.com
PAPERLESS_EMAIL_PASSWORD: "passwort"

Oder über die Web-UI: Mail → E-Mail-Konten hinzufügen → Regeln definieren, welche Anhänge importiert werden sollen.

Ich nutze das, um Rechnungen die per E-Mail ankommen direkt ins System zu schleusen. In Kombination mit einem lokalen E-Mail-Weiterleitungsfilter ist der Prozess vollständig automatisiert.

Mobile App und Drittanbieter-Integration

Es gibt mehrere inoffizielle Mobile-Apps:

Paperless Mobile (Android/iOS) — vollwertige App zum Scannen und Verwalten
SwiftyTesseract — für eigene iOS-Integrationen

Über die REST-API lässt sich Paperless-ngx mit fast allem verbinden:

n8n / Make: Automatisierungsworkflows mit Dokumenten
Home Assistant: Automatisch importierte Scans aus smarten Dokumentenscannern
Paperless Share (Android): Teilen-Menü zum direkten Upload aus anderen Apps

Mein Setup in Kubernetes

In meinem Kubernetes-Cluster (RKE2/k3s) läuft Paperless-ngx als Deployment mit:

PostgreSQL via CloudNativePG Operator
Redis als eigenständiges Deployment
Longhorn für persistenten Storage (Medien, Daten)
Traefik als Ingress Controller mit TLS-Terminierung über Let's Encrypt
NFS-Consume-Volume: Dokumentenscanner schreibt direkt in den Consume-Ordner

Die Sicherung erfolgt über Velero (Backup der PVCs) und einen nächtlichen Paperless-Export (document_exporter) nach MinIO.

Tipps für den Alltag

Scannen: Ein Fujitsu ScanSnap oder Brother-ADF-Scanner mit TWAIN-Unterstützung macht den Prozess reibungslos. Alternativ reicht ein Smartphone mit einer Scanner-App.

Benennungsschema: Paperless-ngx kann Dateien nach einem Schema umbenennen: {created_year}/{correspondent}/{title}

Datenschutz: Da alles lokal läuft, gelten keine DSGVO-Risiken durch Cloud-Transfer. Besonders für Steuerberater, Ärzte oder sensible Privatdaten ein echter Vorteil.

Backup: Den Paperless-Export (./export) regelmäßig sichern — er enthält alle Dokumente im Original plus JSON-Metadaten für eine vollständige Wiederherstellung.

Fazit

Paperless-ngx ist das beste Dokumentenmanagementsystem für Self-Hoster. Es ist kostenlos, mächtig, aktiv entwickelt und benötigt keine Cloud. Die automatische OCR, KI-Klassifikation und die schnelle Volltextsuche machen papierbasierte Ablage überflüssig.

Wer seine Dokumente unter Kontrolle behalten und trotzdem komfortabel suchen möchte, sollte Paperless-ngx ausprobieren — es braucht weniger als 30 Minuten bis zum ersten Dokument.

Getestet auf: k3s/RKE2, Hetzner Cloud CX22 Letzte Aktualisierung: August 2026

Paperless-ngx: Dokumentenmanagement selbst hosten – Setup-Guide 2026