Paperless und KI passend zu Ihren Dokumenten aufsetzen?
WZ-IT prüft, ob die native KI-Integration von Paperless-ngx oder Paperless-AI zum Bestand passt, und übernimmt Installation, Absicherung und Betrieb. Für sensible Dokumente kann der AI Cube die lokale Modellplattform im eigenen Netzwerk bereitstellen.
Paperless-KI umsetzen lassen · AI Cube ansehen · Erstgespräch vereinbaren
Paperless-AI ist eine KI-gestützte Erweiterung für Paperless-NGX, die Ihre Dokumentenverwaltung auf ein neues Level hebt. Mit automatischer Dokumentenklassifizierung, intelligenter Tag-Vergabe und semantischer Suche können Sie Ihre Dokumente noch effizienter verwalten. In dieser Anleitung zeigen wir Ihnen, wie Sie Paperless-AI zu Ihrer bestehenden Paperless-NGX Installation hinzufügen.
Voraussetzung: Diese Anleitung setzt voraus, dass Sie bereits Paperless-NGX installiert haben. Falls nicht, folgen Sie zuerst unserer Paperless-NGX Installationsanleitung.
Schneller geht's mit unserem Installer-Skript! Wir haben ein kostenloses One-Liner Installer-Skript für Paperless-AI erstellt: Paperless-AI Installer-Skript - Installation per einem Befehl mit automatischem Docker-Setup und optionalem HTTPS via Caddy.
Stand Oktober 2026: bitte zuerst lesen
Zwei Dinge haben sich seit Erscheinen dieses Beitrags geändert.
Paperless-ngx kann KI inzwischen selbst. Die Konfiguration kennt
PAPERLESS_AI_ENABLED,PAPERLESS_AI_LLM_BACKENDundPAPERLESS_AI_LLM_EMBEDDING_BACKEND- inklusive Ollama als lokalem Backend, Chat mit Dokumenten und Ähnlichkeitssuche. Wenn Sie neu anfangen, prüfen Sie zuerst die native Integration; für viele Anwendungsfälle brauchen Sie dann kein zusätzliches Projekt. Einrichtung mit Ollama und Umstieg zeigt der Guide Paperless-ngx mit KI einrichten.Das Paperless-AI-Projekt ist seit dem 31.03.2026 nicht mehr in Wartung. Der Maintainer schreibt im Repository: "This repo is currently not maintained" - er arbeitet an einem Rewrite, lässt aber ausdrücklich offen, ob er ihn fertigstellt oder das Projekt weiterführt, unter anderem wegen genau dieser nativen Integration. Das letzte Release ist v3.0.9 vom 4. November 2025.
Die Anleitung unten funktioniert weiterhin. Für neue produktive Installationen empfehlen wir die native KI von Paperless-ngx, die seit Version 3.0.0 vom 22.07.2026 mit dem Hauptprojekt gepflegt wird. Wenn Sie Paperless-AI weiter einsetzen, sollten Sie den Wartungsstand kennen - und wenn Sie abwägen möchten, was in Ihrem Fall sinnvoller ist: kurz sprechen.
Inhaltsverzeichnis
- Funktionsumfang von Paperless-AI
- Voraussetzungen
- Installation
- HTTPS mit Caddy einrichten
- Erstkonfiguration
- Container neu starten (wichtig!)
- Verwendung
- Tipps für den Betrieb
- Fehlerbehebung
- Fazit
Funktionsumfang von Paperless-AI
Paperless-AI erweitert Paperless-NGX um beeindruckende KI-Funktionen:
Automatische Dokumentenverarbeitung
- Erkennt neue Dokumente automatisch
- Analysiert Inhalte mit KI-Modellen
- Vergibt automatisch Titel, Tags, Dokumententyp und Korrespondent
RAG-basierter KI-Chat
Stellen Sie in der Weboberfläche von Paperless-AI natürlichsprachliche Fragen zu Ihren Dokumenten:
- "Wann habe ich meinen Mietvertrag unterschrieben?"
- "Wie hoch war die letzte Stromrechnung?"
- "Welche Dokumente erwähnen meine Krankenversicherung?"
Flexible Konfiguration
- Aktivieren Sie nur die gewünschten Funktionen
- Definieren Sie Regeln für die Dokumentenverarbeitung
- Unterstützt verschiedene KI-Modelle
Paperless ohne Setup- und Wartungsstress?
Die Installation ist nur der Anfang - Updates, Backups, SSL und Sicherheit kommen danach. Wir hosten und betreiben Paperless und über 52 weitere Open-Source-Apps DSGVO-konform in der EU, inklusive CVE-Monitoring.
Voraussetzungen
- Ubuntu Server (getestet mit 24.04)
- Funktionierende Paperless-NGX Installation
- Docker und Docker Compose
Installation
1. In das Paperless-Verzeichnis wechseln
cd /opt/paperless
2. Paperless-AI klonen und starten
sudo git clone https://github.com/clusterzx/paperless-ai.git
cd paperless-ai
sudo docker compose up -d
Das war's schon! Paperless-AI läuft nun auf Port 3000.
3. API-Schlüssel aus Paperless-NGX auslesen
Loggen Sie sich in Ihre Paperless-NGX Installation ein und navigieren Sie zu Ihren Profileinstellungen. Dort finden Sie Ihren API-Token, den Sie für die Verbindung mit Paperless-AI benötigen.
HTTPS mit Caddy einrichten
Da Sie bereits Paperless-NGX mit Caddy betreiben, fügen wir Paperless-AI als Subdomain hinzu.
1. DNS-Eintrag erstellen
Erstellen Sie einen A-Record für Ihre Subdomain:
- Subdomain:
paperless-ai - Typ: A
- Ziel: IP-Adresse Ihres Servers
2. Caddy-Konfiguration erweitern
Bearbeiten Sie Ihre bestehende Caddy-Konfiguration:
sudo nano /opt/paperless/caddy/Caddyfile
Fügen Sie folgenden Abschnitt hinzu:
# Paperless-AI Subdomain
paperless-ai.ihre-domain.de {
reverse_proxy localhost:3000
}
3. Caddy neu laden
sudo systemctl reload caddy
Caddy erstellt automatisch ein SSL-Zertifikat für die neue Subdomain.
Erstkonfiguration
1. Paperless-AI Setup-Assistenten öffnen
Öffnen Sie in Ihrem Browser:
https://paperless-ai.ihre-domain.de
Der Setup-Assistent startet automatisch beim ersten Aufruf.
2. Paperless-NGX Verbindung einrichten
Im Setup-Assistenten:
- Paperless URL: Geben Sie die HTTPS-URL Ihrer Paperless-NGX Installation ein
Beispiel:https://paperless.ihre-domain.de - Username: Ihr Paperless-NGX Benutzername
- API Token: Fügen Sie den zuvor kopierten API-Token ein
3. KI-Modell konfigurieren
Wählen Sie Ihr bevorzugtes KI-Modell:
Option 1: OpenAI
- Model:
gpt-4o-mini(kostengünstig und effizient) - API Key: Ihren OpenAI API-Schlüssel eingeben
Option 2: Andere unterstützte Anbieter
- DeepSeek, OpenRouter, Perplexity, Together.ai und viele mehr
- Lokale Modelle mit Ollama für maximalen Datenschutz
Datenschutz-Tipp: Für sensible Dokumente empfehlen wir die Nutzung lokaler KI-Modelle. Der AI Cube stellt das Sprachmodell im eigenen Netz bereit, sodass Dokumente das Haus nicht verlassen (7.990 € netto einmalig plus AI Cube Care ab 349,90 € netto im Monat); gehostet geht es mit einem Managed GPU Server ab 699 € netto im Monat.
4. Funktionen aktivieren
Nach erfolgreicher Einrichtung gelangen Sie zum Dashboard. Aktivieren Sie die gewünschten Funktionen:
- Title Generation: Automatische Titelvergabe basierend auf dem Dokumentinhalt
- Tag Assignment: Intelligente Tag-Zuweisung
- Document Type Classification: Automatische Dokumententyp-Erkennung
- Correspondent Detection: Erkennung von Absendern/Korrespondenten
Container neu starten (wichtig!)
Nach der Erstkonfiguration muss der Container einmal neu gestartet werden, damit der RAG-Index aufgebaut wird:
cd /opt/paperless/paperless-ai
sudo docker compose restart
Verwendung
Automatische Verarbeitung
Sobald neue Dokumente in Paperless-NGX eingehen, werden diese automatisch von Paperless-AI analysiert und mit Metadaten versehen.
KI-Chat für Dokumente
Der Chat ist Teil der eigenen Weboberfläche von Paperless-AI, nicht von Paperless-NGX:
- Öffnen Sie
https://paperless-ai.ihre-domain.deund melden Sie sich an - Wechseln Sie in den Chat-Bereich
- Stellen Sie Fragen zu Ihren Dokumenten; die Antworten stützen sich auf den RAG-Index
Ein Chat direkt in der Oberfläche von Paperless-ngx gehört zur nativen KI-Integration ab Version 3.0.0, siehe Paperless-ngx mit KI einrichten.
Manuelle Verarbeitung
Für sensible Dokumente können Sie unter https://paperless-ai.ihre-domain.de/manual Dokumente manuell zur Verarbeitung auswählen.
Tipps für den Betrieb
1. Regeln definieren
Sie können Regeln erstellen, um zu steuern, welche Dokumente verarbeitet werden:
- Nur bestimmte Tags verarbeiten
- Dokumente mit sensiblen Informationen ausschließen
- Automatische Aktionen für bestimmte Dokumenttypen
2. Performance optimieren
- Verwenden Sie
gpt-4o-minifür ein gutes Preis-Leistungs-Verhältnis - Bei vielen Dokumenten: Batch-Verarbeitung in den Einstellungen aktivieren
- Lokale Modelle: Mindestens 8GB RAM für optimale Performance
3. Monitoring
# Logs anzeigen
sudo docker compose logs -f
# Container-Status prüfen
sudo docker ps
Fehlerbehebung
Verbindung zu Paperless-NGX schlägt fehl
- Prüfen Sie, ob die URL korrekt ist (mit https://)
- Stellen Sie sicher, dass der API-Token gültig ist
- Firewall-Regeln überprüfen
KI-Modell antwortet nicht
- API-Schlüssel und Guthaben prüfen
- Logs checken:
sudo docker compose logs -f
Container startet nicht
# Berechtigungen prüfen
sudo chown -R 1000:1000 /opt/paperless/paperless-ai
# Container neu neustarten
sudo docker compose down
sudo docker compose up -d
Fazit
Mit Paperless-AI verwandeln Sie Ihre Paperless-NGX Installation in ein intelligentes Dokumentenmanagementsystem. Die KI-gestützte Analyse und Kategorisierung spart Zeit und macht Ihre Dokumente durch semantische Suche noch besser auffindbar.
Sie möchten Paperless-AI professionell in Ihrem Unternehmen einsetzen? Wir unterstützen Sie bei der Installation, Konfiguration und dem Betrieb - inklusive lokaler KI-Modelle auf dedizierten Servern.
🚀 Lokale KI-Inferenz mit dem AI Cube
Für maximale Datensouveränität und Performance empfehlen wir unseren AI Cube - eine vollständig vorkonfigurierte Plattform für lokale LLM-Inferenz:
Passend für Dokumenten-KI und RAG-Setups:
- ✅ Keine Cloud-Abhängigkeit - die Dokumente bleiben in Ihrem Netz
- ✅ Vorinstallierte Software - Ollama, vLLM und auf Wunsch Open WebUI bereits konfiguriert
- ✅ Plug & Play - anschließen, einschalten, loslegen
- ✅ Konfiguriert und in Betrieb genommen in Deutschland - Support und Wartung aus einer Hand
Die Varianten:
- AI Cube - NVIDIA GB10, 128 GB Unified Memory, 7.990 € netto einmalig inklusive Einrichtung, Einweisung und Versand; Betrieb optional über AI Cube Care ab 349,90 € netto im Monat; die ersten zwölf Monate laufen mit dem Gerät, danach ist Care monatlich kündbar
- AI Cube Custom - freie Komponentenwahl für größere Modelle oder viele parallele Nutzer
Mehr über den AI Cube erfahren
Jetzt Erstgespräch vereinbaren
Nächster Schritt
Open-Source-Software betreiben lassen?
Über 52 gemanagte Anwendungen - von Paperless über Nextcloud bis n8n. Ihr nutzt, wir betreiben: Updates, Sicherheit und Verfügbarkeit aus einer Hand, gehostet in deutschen bzw. EU-Rechenzentren.
Weiterlesen: Paperless-NGX installieren · n8n produktiv betreiben · Twenty CRM aufsetzen
