Paperless Sync¶
Deine fertigen Paperless-ngx-Dokumente als aufgeräumtes Archiv in Nextcloud.
Eine native Nextcloud-App, die fertig bearbeitete Paperless-ngx-Dokumente in ein strukturiertes Archiv in Nextcloud spiegelt und Dateien aus einem Nextcloud-Eingang an Paperless übergeben kann. Paperless bleibt die maßgebliche Quelle.
- Nextcloud 33–35
- PHP 8.2+
- Paperless-ngx 2.16+ mit einem API-Token
- Der System-Cron von Nextcloud
Im App Store holen Ausprobieren Schnellstart Voraussetzungen
Für wen¶
-
Ein Haushalt
Die Unterlagen der Familie liegen in Paperless, und alle finden sie in Nextcloud, auch auf dem Handy: in einem Archiv, das du teilst, oder jede Person mit den Dokumenten, die ihr in Paperless gehören.
-
Ein kleines Büro
Das Team sendet Dateien aus Nextcloud Dateien an Paperless, Regeln von Flow tun es von selbst, und wer Paperless betreut, bekommt die Einstellungen, ohne Nextcloud zu administrieren.
-
Paperless auf einem NAS
Paperless darf auf einem anderen Gerät laufen: Die App erreicht es über seine REST-API, ohne einen Container daneben und ohne Zugriff auf seinen Medienordner, und ein Schalter erlaubt eine Adresse deines Netzwerks.
Was es tut¶
Archiv¶
-
Ein strukturiertes Archiv in Nextcloud
Die Dokumente erscheinen in Ordnern des eingestellten Nextcloud-Benutzers, standardmäßig zuerst nach Korrespondent, als Archiv-PDF oder Originaldatei. Eine Pfadvorlage bestimmt, wohin jedes kommt, und ihre Vorschau zeigt es schon beim Tippen.
-
Folgt den Änderungen in Paperless
Ändern sich die Metadaten eines Dokuments in Paperless, wird seine Datei in Nextcloud umbenannt oder verschoben, mit ihren Freigaben, Kommentaren und Versionen. Dokumente im Posteingang von Paperless oder mit einem ausgeschlossenen Tag bleiben draußen, und das Archiv kann nur die Dokumente mit den Tags spiegeln, die du wählst.
-
Tags und Metadaten kommen mit
Die Tags von Paperless können als Tags von Nextcloud auf den Kopien erscheinen, sodass Dateien nach ihnen filtert und sucht. Eine JSON-Datei für jedes Dokument und ein Index als CSV halten seine Tags, Notizen, benutzerdefinierten Felder und Daten neben dem Archiv fest, das sich dann auch ohne Paperless selbst beschreibt.
-
Jedem Benutzer seine Dokumente
Ein Benutzer kann das Archiv besitzen und teilen. Oder jeder Benutzer von Nextcloud erhält die Dokumente, die ihm in Paperless gehören, in seinen eigenen Dateien, über die eine Verbindung der App, und auf Wunsch auch die, die Paperless mit ihm teilt.
Eingang und Dateien¶
-
Aus einem Nextcloud-Eingang zu Paperless
Dateien in einem Eingangsordner von Nextcloud, auch in seinen Unterordnern, werden mit ihren Tags an Paperless übergeben, und die App verfolgt ihre Paperless-Aufgaben. Ein fehlgeschlagener Import wandert in einen Fehlerordner, neben den Grund.
-
An Paperless senden in Dateien
Das Menü einer Datei oder eines Ordners sendet sie an Paperless, für die Mitglieder einer Gruppe, die du wählst. Sie bleibt, wo sie ist, und eine Benachrichtigung verlinkt das neue Dokument. In Paperless öffnen im Menü einer Kopie öffnet ihr Dokument.
-
Regeln von Flow
Regeln von Flow senden Dateien von selbst, mit eigenen Tags, etwa jedes PDF, das ein Mitglied einer Gruppe hochlädt. Nur die Administratoren erstellen sie.
-
Dateien sagt, was ein Ordner tut
Ein Hinweis über der Liste sagt, dass das Archiv ein Spiegel ist, wann der Eingang seine Dateien sendet und wo die Gründe fehlgeschlagener Importe liegen, auch für Menschen, die den Ordner über eine Freigabe erreichen.
Betrieb¶
-
Änderungen in Sekunden
Ein Arbeitsablauf von Paperless ruft den Webhook der App auf, wenn er ein Dokument hinzufügt oder ändert, und seine Kopie ändert sich sofort, ohne einen Container neben Paperless, seinen Medienordner oder ein Passwort von Nextcloud.
-
Erste Schritte, einer nach dem anderen
Bis der erste Lauf erfolgreich war, öffnen sich die Einstellungen mit den Schritten des Schnellstarts in ihrer sicheren Reihenfolge. Auswahlfelder bieten die Benutzer und die Tags an und markieren einen, den es nicht gibt. Die Administratoren können die Einstellungen an eine Gruppe delegieren.
-
Sagt dir, wenn die Spiegelung scheitert
Benachrichtigungen, Einrichtungsprüfungen und eine Status-API sagen den Administratoren, wenn die Spiegelung immer wieder scheitert oder stehen geblieben ist, auch in Uptime Kuma oder Home Assistant. Der Aktivitätenstrom des Zielbenutzers erzählt, was jeder Lauf geändert und importiert hat.
-
Nach Plan, auf Abruf oder aus einem Skript
Der Cron von Nextcloud führt die App in dem Intervall aus, das du einstellst, und die Batchgröße begrenzt die Änderungen eines Laufs. Ein Lauf startet auch aus den Einstellungen, und
occ-Befehle dienen Skripten, Cron-Jobs und der Überwachung, mit JSON-Ausgabe und Exit-Codes.
Sicherheit¶
-
Zuerst ein Testlauf
Die Synchronisation bleibt aus, bis du sie einschaltest. Ein Testlauf listet auf, was ein Lauf ändern würde, ohne etwas zu ändern. Der Status, die Fehler und der Bericht des letzten Laufs, auch eines geplanten, bleiben auf der Einstellungsseite.
-
Vorsichtig beim Löschen
Der Papierkorb von Paperless wird in einen eigenen Ordner gespiegelt. Endgültiges Löschen ist standardmäßig aus und wartet, wenn es eingeschaltet ist, auf die eingestellte Zahl vollständiger Scans.
-
Keine Passwörter in Nextcloud
Die App arbeitet über die Dateisystem-API von Nextcloud, ohne WebDAV-Zugangsdaten oder ein App-Passwort. Ihr Konto in Paperless ist kein Superuser, und das Paperless-Token bleibt im Anmeldedaten-Speicher von Nextcloud und erreicht nie den Browser.
-
Eine Verbindung, die sie prüft
Verbindung testen prüft jede Berechtigung, die deine Module brauchen, und nennt, was in Paperless zu vergeben ist. Ein Paperless in deinem lokalen Netzwerk funktioniert, ohne den Schutz von Nextcloud vor serverseitiger Anforderungsfälschung für den ganzen Server auszuschalten.
Die Einstellungen sprechen Englisch und Deutsch. Sie, die Aktionen in Dateien und das Formular der Regel in Flow werden in jeder Änderung der App auf Barrierefreiheit nach WCAG 2.1 AA geprüft. Jedes Release ist signiert, dasselbe Paket im Nextcloud App Store und auf GitHub, mit einer SBOM und signierter Build-Provenienz.
So funktioniert es¶
Im eingestellten Intervall startet der Cron von Nextcloud einen Lauf der App in Nextcloud. Er liest die fertigen Dokumente von Paperless und schreibt jedes in das Archiv in den Dateien des eingestellten Nextcloud-Zielbenutzers, an den Pfad, den die Pfadvorlage aus seinen Metadaten bildet; andere Benutzer sehen das Archiv, wenn dieser Benutzer es mit ihnen teilt. Ändern sich die Metadaten in Paperless, wandert die Datei; kommt ein Dokument in den Papierkorb von Paperless, wandert seine Kopie nach _Gelöscht. Dateien, die jemand in Eingang legt, gehen den umgekehrten Weg, zu Paperless.
Ausprobieren¶
Sehen Sie die App in wenigen Minuten bei der Arbeit, ohne eigene Nextcloud und ohne eigenes Paperless-ngx. Mit Docker unter Linux oder mit Docker Desktop unter Windows oder macOS:
git clone https://github.com/Dennis-Otto/paperless-sync.git
cd paperless-sync
docker compose -f demo/compose.yaml up
Das startet Nextcloud und Paperless-ngx allein auf Ihrem Rechner, füllt Paperless mit einem erfundenen Archiv eines Haushalts, installiert die App aus dem App Store und verbindet sie, zuerst mit einem Probelauf und dann mit dem ersten Lauf. Danach nennt der Befehl die Adresse des Archivs und das Passwort, das er erzeugt hat und das in demo/.env bleibt. docker compose -f demo/compose.yaml down --volumes entfernt alles wieder.
demo/README.md im Repository sagt auf Englisch, was Sie darin ausprobieren können.
Schnellstart¶
- Installiere Paperless Sync aus dem Nextcloud App Store unter Apps oder mit
occ app:install paperless_sync. Der System-Cron von Nextcloud muss laufen. - Öffne in Nextcloud Administrationseinstellungen → Paperless Sync. Gib die Paperless-Adresse ein, wähle den Nextcloud-Benutzer, dem das Archiv gehört, aus den Benutzern, die das Feld anbietet, und schalte die Module ein, die du möchtest, etwa den Eingang. Für ein Paperless unter einer Adresse deines Netzwerks, etwa
http://paperless:8000, schalte Paperless läuft in meinem lokalen Netzwerk ein. Lass die Synchronisation ausgeschaltet. - Öffne Ein Konto für die App in Paperless anlegen, gib das API-Token eines Paperless-Superusers ein, aus Mein Profil in seinem Menü, und klicke auf Konto anlegen und speichern. Die App legt den Benutzer
nextcloud-syncan, keinen Superuser, mit nur den Berechtigungen, die deine Module brauchen, und einem zufälligen Passwort, speichert die Einstellungen mit dem Token dieses Benutzers, nie mit deinem, und zeigt die Verbindungs-Checkliste. Mach das Konto danach zum Eigentümer der zu spiegelnden Dokumente, damit ihr Papierkorb das Archiv sofort erreicht, wie es die Checkliste sagt. Um das Token deines Superusers aus Nextcloud herauszuhalten, lege das Konto von Hand an, wie Das Konto der App unter Konfiguration beschreibt, gib sein Token in Paperless-API-Token ein und klicke stattdessen auf Verbindung testen. - Starte einen Testlauf und lies seine Zusammenfassung: Er listet auf, was ein Lauf ändern würde, ohne etwas zu ändern.
- Schalte die Synchronisation ein und speichere. Der Cron von Nextcloud führt sie im eingestellten Intervall aus, und die Dokumente erscheinen in
Dokumente/Paperless/Archivdieses Benutzers, auf einem Nextcloud mit der Standardsprache Deutsch; sonst inDocuments/Paperless/Archive.
Die Anleitung beschreibt die Konfiguration im Detail: das Paperless-Konto, die Ordner, die Pfadvorlage und die Löschsicherheit.
Mehr erfahren¶
Die Anleitung, die Seite zum Nutzen des Archivs, die FAQ, die Fehlerbehebung und der Vergleich gibt es auf Deutsch, die übrigen Seiten auf Englisch.
-
Anleitung
Installation, alle Funktionen, die Verwendung und jeder Teil der Konfiguration.
-
Das Archiv nutzen
Für die Menschen, die die Dokumente lesen und senden: sie finden, Dateien an Paperless senden, mit dem Handy scannen, offline halten und teilen.
-
FAQ und Fehlerbehebung
Was mit Bearbeitungen und Löschungen geschieht, wie lange die erste Synchronisation dauert, und die Lösungen für die Fehlermeldungen.
-
Der Vergleich
Paperless Sync neben der Paperless-Integration von Nextcloud, dem WebDAV-Container, rclone und einem Mount, und wie du umsteigst.
-
Architektur
Wie die App in Nextcloud läuft, Paperless über seine REST-API liest und Dateien über die Datei-API von Nextcloud schreibt.
-
Sicherheitsdesign
Was die App schützt, wem sie vertraut, die Bedrohungen mit ihren Gegenmaßnahmen und die Risiken, die bleiben.
-
Roadmap
Was Paperless Sync in den nächsten zwölf Monaten vorhat, und was es nicht tun wird.
-
Entscheidungen
Die Entscheidungen, die das Projekt prägen, jede mit ihren Gründen.
-
Automatisierung
Die Bots, die jede Änderung prüfen, die App veröffentlichen und verifizieren, Issues beantworten und das Repository aktuell halten.
-
Entwicklung und Releases
Wie du die App baust und testest, wie ein Release entsteht, signiert und im Nextcloud App Store veröffentlicht wird, und die Änderungen jeder Version.
Hilfe und Feedback¶
- Eine Frage zur Einrichtung, oder ob die App etwas kann: Frag in den Q&A-Diskussionen, wo die Antwort für die nächste Person bleibt, die fragt; Englisch hilft den meisten Lesern, Deutsch ist willkommen.
- Ein Fehler: Öffne einen Fehlerbericht mit den Versionen der App und von Nextcloud. Melde eine Sicherheitslücke stattdessen vertraulich.
- Eine Idee: Schlag sie in einem Funktionswunsch vor.
- Wenn die App dir hilft: Bewerte sie im Nextcloud App Store, damit andere sie finden, gib dem Repository einen Stern oder unterstütze seine Entwicklung.




![Nextcloud Dateien im Ordner Example Bank/Letter/2026 des Archivs mit der Kopie 2026-10-07 - Credit card terms [P190].pdf. Eine Bildunterschrift sagt, dass das Dokument in Paperless den Typ Contract und den neuen Titel Credit card agreement erhält, dann, dass der nächste Lauf die Kopie in den Ordner ihres neuen Typs verschiebt und ihr den neuen Namen gibt. Der Zeiger öffnet Example Bank, das jetzt Contract und Statement enthält und keinen Ordner Letter mehr, dann Contract und 2026, wo die Kopie 2026-10-07 - Credit card agreement [P190].pdf heißt](../images/de/move.gif#only-light)
![Nextcloud Dateien im Ordner Example Bank/Letter/2026 des Archivs mit der Kopie 2026-10-07 - Credit card terms [P190].pdf. Eine Bildunterschrift sagt, dass das Dokument in Paperless den Typ Contract und den neuen Titel Credit card agreement erhält, dann, dass der nächste Lauf die Kopie in den Ordner ihres neuen Typs verschiebt und ihr den neuen Namen gibt. Der Zeiger öffnet Example Bank, das jetzt Contract und Statement enthält und keinen Ordner Letter mehr, dann Contract und 2026, wo die Kopie 2026-10-07 - Credit card agreement [P190].pdf heißt](../images/de/move-dark.gif#only-dark)































