Paperless-AI Installation: KI-gestützte Dokumentenanalyse für Paperless-NGX

Hinweis zum Inhalt: Die Informationen in diesem Artikel wurden nach bestem Wissen zum Zeitpunkt der Veröffentlichung zusammengestellt. Technische Details, Preise, Versionen, Lizenzmodelle und externe Inhalte können sich ändern. Bitte prüfen Sie die genannten Angaben eigenständig, insbesondere vor geschäftskritischen oder sicherheitsrelevanten Entscheidungen. Dieser Artikel ersetzt keine individuelle Fach-, Rechts- oder Steuerberatung.

Sie interessieren sich für das vorgestellte Produkt? Sprechen Sie uns an! Bei WZ-IT übernehmen wir Beratung, Installation, Support, Betrieb, Wartung und Monitoring Ihrer Lösung.
Installation Service - Professionelle Installation auf Ihrer Infrastruktur (On-Premise, Cloud oder Hybrid) mit KI-Integration, RAG-Setup und Security Hardening.
Managed Hosting Service - DSGVO-konformes Enterprise Managed Hosting in Deutschland mit 24/7 Monitoring, Support SLA und automatischen Updates.
Vereinbaren Sie hier Ihr kostenloses und unverbindliches Gespräch: Termin 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.
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 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. Wir bieten auch dedizierte KI-Server an, auf denen Sie Ihre eigenen Modelle betreiben können.
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
- Öffnen Sie ein Dokument in Paperless-NGX
- Klicken Sie auf den "AI Chat" Button
- Stellen Sie Fragen zum Dokumentinhalt
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 datenschutzkonformer 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 plug-and-play Lösung für lokale LLM-Inferenz:
Perfekt für Paperless AI & RAG-Setups:
- ✅ Keine Cloud-Abhängigkeit - Ihre Dokumente bleiben zu 100% lokal
- ✅ Vorinstallierte Software - Ollama, vLLM, Open WebUI bereits konfiguriert
- ✅ Enterprise-Grade Hardware - RTX PRO 4000/5000/6000 Blackwell mit bis zu 96 GB VRAM
- ✅ Plug & Play - Einschalten und direkt loslegen
- ✅ Made in Germany - Support, Wartung und Hosting aus einer Hand
Enterprise KI-Hardware:
- AI Cube Pro (RTX PRO 6000 Blackwell, 96 GB VRAM)
- Custom-Konfigurationen für individuelle Anforderungen
🔗 Mehr über den AI Cube erfahren
Jetzt Beratungstermin 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

Geschrieben von
Timo Wevelsiep
Co-Founder & CEO
Co-Founder von WZ-IT. Spezialisiert auf Cloud-Infrastruktur, Open-Source-Plattformen und Managed Services für KMUs und Enterprise-Kunden weltweit.
LinkedInLassen Sie uns über Ihre Idee sprechen
Ob konkrete IT-Herausforderung oder einfach eine Idee - wir freuen uns auf den Austausch. In einem kurzen Gespräch prüfen wir gemeinsam, ob und wie Ihr Projekt zu WZ-IT passt.


Timo Wevelsiep & Robin Zins
Geschäftsführer





