Hilfe
Hier stehen die Fragen, die beim Einrichten am häufigsten auftauchen. Wenn deine nicht dabei ist, schreib uns an info@paperlesschat.app.
Paperless-KI einrichten
Paperless Chat nutzt die KI, die in deinem Paperless-ngx eingebaut ist. Dafür brauchst du Paperless-ngx 3.0 oder neuer. Ein Admin schaltet die KI in der Konfiguration von Paperless ein, wählt ein Sprachmodell, etwa über Ollama oder eine OpenAI-kompatible Schnittstelle, und ein Modell für die Embeddings. Danach baut Paperless einen Index über deine Dokumente auf. Erst wenn der fertig ist, findet der Chat passende Dokumente.
Die Einstellungen im Einzelnen beschreibt die Konfiguration in der Paperless-Doku.
Als Admin kannst du die KI-Einstellungen auch in der App unter Einstellungen › Paperless-KI ändern. Bevor die App speichert, zeigt sie dir jede Änderung. Die Änderungen gelten für alle Nutzer deines Paperless-Servers.
Meldet die App „Die KI ist auf deinem Paperless-Server ausgeschaltet.“, ist die KI in Paperless noch nicht eingeschaltet.
Token finden
Öffne die Weboberfläche von Paperless und klick oben rechts auf deinen Benutzernamen. Im Profil findest du den API-Token. Erzeuge dort einen Token, falls noch keiner existiert, und kopiere ihn. In der App wählst du bei der Anmeldung „API-Token“ und fügst ihn ein.
Ein Token hat dieselben Rechte wie dein Benutzer. Wenn du ihn neu erzeugst, ist der alte sofort ungültig, und du meldest dich in der App neu an.
Zwei-Faktor-Anmeldung
Wenn du dich mit Benutzername und Passwort anmeldest und in Paperless die Zwei-Faktor-Anmeldung aktiv ist, fragt die App nach dem sechsstelligen Code aus deiner Authenticator-App. Danach arbeitet sie mit einem Token weiter, Passwort und Code speichert sie nicht.
Paperless lässt nur fünf Anmeldeversuche pro Minute zu. Wenn die App meldet, dass zu viele Versuche kamen, warte eine Minute. Alternativ meldest du dich direkt mit einem Token an, dann braucht es keinen Code.
Wiederherstellungscodes funktionieren bei der Anmeldung mit Passwort in der App nicht, die App nimmt nur den Code aus der Authenticator-App. Hast du nur noch einen Wiederherstellungscode, melde dich damit in der Weboberfläche von Paperless an, erzeuge dort einen API-Token (siehe Token finden) und melde dich in der App mit dem Token an.
Selbst signierte Zertifikate
Hat dein Server ein selbst signiertes oder unbekanntes Zertifikat, zeigt die App den Aussteller und den SHA-256-Fingerabdruck. Vergleiche ihn mit dem Zertifikat auf deinem Server, zum Beispiel so:
openssl x509 -noout -fingerprint -sha256 -in zertifikat.pem
Erst wenn du bestätigst, vertraut die App genau diesem Zertifikat und keinem anderen. Ändert sich der Fingerabdruck später, etwa nach einer Erneuerung, fragt sie erneut.
Im Heimnetz geht auch eine Verbindung per http. Die App zeigt dann dauerhaft den Hinweis „Unverschlüsselte Verbindung“.
Proxy-Anmeldung und Zusatz-Header
Liegt vor deinem Paperless eine eigene Anmeldung, etwa Authelia, Authentik, oauth2-proxy oder Cloudflare Access, bekommt die App statt Paperless eine Login-Seite. Eine Anmeldung per Webseite unterstützt die App noch nicht. Sie kann aber bei jeder Anfrage Zusatz-Header mitsenden, mit denen dein Proxy sie durchlässt. Du trägst sie unter Verbindung › Erweitert ein.
Beispiel: Cloudflare Access
- Leg in Cloudflare Zero Trust ein Service-Token an. Du bekommst eine Client-ID und ein Client-Secret.
- Füge der Access-Anwendung für deinen Paperless-Server eine Richtlinie mit der Aktion „Service Auth“ hinzu, die dieses Service-Token zulässt.
- Trag in der App zwei Zusatz-Header ein:
CF-Access-Client-Id: <Client-ID>
CF-Access-Client-Secret: <Client-Secret>
Die App speichert Zusatz-Header verschlüsselt und sendet sie nur an deinen Server, auch beim Laden von Vorschaubildern und Dokumenten.
Basic-Auth am Proxy
Verlangt dein Proxy Benutzername und Passwort per Basic-Auth, trag sie unter Verbindung › Erweitert als Proxy-Benutzer und Proxy-Passwort ein. Die App sendet sie als Proxy-Authorization. Viele Reverse-Proxys erwarten Basic-Auth aber im Header Authorization, und den braucht Paperless für den Token. Nimm in diesem Fall den Pfad /api/ von der Basic-Auth aus oder nutze Zusatz-Header.
Client-Zertifikate (mTLS) unterstützt die App noch nicht.
Antworten kommen am Stück statt nach und nach
Paperless schickt die Antwort Stück für Stück, während das Modell sie schreibt. Puffert ein Reverse-Proxy die Antwort, kommt sie erst an, wenn sie fertig ist. Bei nginx schaltest du die Pufferung ab. Füge dazu diese Zeilen in den bestehenden location-Block ein, über den du Paperless erreichst:
proxy_buffering off;
proxy_read_timeout 300s;
Leg dafür keinen neuen location-Block an. nginx übernimmt die proxy_set_header-Zeilen nicht aus anderen Blöcken, und ohne den richtigen Host-Header lehnt Paperless die Anfragen ab. Die zweite Zeile ist optional: Sie verhindert, dass nginx bei langsamen Modellen nach 60 Sekunden ohne Daten abbricht. Lade nginx danach neu, zum Beispiel mit nginx -s reload.
Andere Proxys haben eigene Einstellungen dafür. Traefik puffert zum Beispiel nur, wenn die Buffering-Middleware aktiv ist.
Der Chat kennt meine vorige Frage nicht
Paperless beantwortet jede Frage für sich. Es gibt dort kein Gedächtnis für das Gespräch, und die App täuscht keins vor. Eine Nachfrage wie „und im Jahr davor?“ versteht Paperless deshalb nicht.
Stell die Frage vollständig, oder tippe bei der letzten Frage auf „Frage anpassen“ und ändere sie. Willst du nur ein bestimmtes Dokument fragen, öffne es und wähle „Zu diesem Dokument fragen“.
Vorlesen und Spracheingabe
Jede fertige Antwort kannst du dir vorlesen lassen, auf iOS und Android. Die App nutzt dafür die Stimmen deines Geräts. Auf Android erscheint „Vorlesen“ nur, wenn eine Stimme ohne Netzverbindung installiert ist. Stimmen lädst du in den Systemeinstellungen unter Sprachausgabe nach.
Auf iPhone und iPad kannst du Fragen auch sprechen. Tippe dafür im leeren Eingabefeld auf das Mikrofon. Die Erkennung läuft nur auf dem Gerät. Ab iOS 26 kann das System dafür beim ersten Mal einmalig ein Sprachpaket laden. Unterstützt dein Gerät die Sprache nicht ohne Server, blendet die App das Mikrofon aus. Auf Android kommt die Spracheingabe mit Version 1.1, bis dahin nutzt du das Diktat deiner Tastatur.
Kontakt
Schreib uns an info@paperlesschat.app. Hilfreich sind die App-Version, dein Gerät, die Paperless-Version und ob ein Proxy davor sitzt. Schick uns bitte nie Token, Passwörter oder Dokumente aus deinem Archiv.