dynaDAT | UNIXoni | REDATEK | ITVeteran - nextcloud

paperless

Anonymous (anonymous@undisclosed.example.com) — 2026-05-03T06:47:04+00:00

Paperless-NGX und Nextcloud Integration mit Docker

Ich habe Paperless-NGX als Docker-Container neben einer Nextcloud-Installation betrieben. Nextcloud läuft als rootless Docker-Container mittels Podman. Eine Verbindung zwischen den Verzeichnissen „consume“ und „archive“ von Paperless und Nextcloud wurde eingerichtet, jedoch mussten einige Herausforderungen gelöst werden.

Problem

Die Verzeichnisse von Paperless als Volume direkt in Nextcloud einzubinden, war aufgrund von Berechtigungsproblemen nicht möglich:

Paperless verwendet standardmäßig paperless (UID=1000) als Benutzer innerhalb des Containers.

Nextcloud läuft als rootless Docker-Container mit einem anderen Benutzer (UID=33, standardmäßig für www-data).

Dies führte zu Zugriffsproblemen, da die Berechtigungen der Verzeichnisse zwischen den beiden Containern inkompatibel waren.

Lösung

Um dieses Problem zu umgehen, habe ich folgende Ansätze evaluiert und umgesetzt:

Option 1: Gemeinsame UID/GID setzen

Eine mögliche Lösung wäre, beide Container mit denselben Benutzer- und Gruppen-IDs auszuführen. Dies kann durch das Setzen der Umgebungsvariablen USERMAP_UID und USERMAP_GID auf 1000 erreicht werden:

USERMAP_UID=1000

USERMAP_GID=1000

Diese Methode würde es ermöglichen, dass beide Container Zugriff auf dieselben Verzeichnisse haben. In meinem Fall war Paperless bereits so konfiguriert, jedoch habe ich mich für eine andere Lösung entschieden, da der Aufwand für die Anpassung von Nextcloud nicht unerheblich war.

Option 2: FTP-Server als Vermittler

Stattdessen habe ich einen FTP-Server (vsftpd) als Vermittler zwischen Paperless und Nextcloud eingerichtet. Der Workflow sieht wie folgt aus:

Paperless speichert exportierte Dokumente direkt auf ein Volume.

Nextcloud synchronisiert diese Verzeichnisse über FTP, periodisch über die interne OCC-Dateiscanschnittstelle. Die Synchronisierung durch Nextcloud ist sehr unzuverlässig. Vor allem, weil Dateiänderungen durch Paperless nicht registriert werden. Durch das triggern einer Synchronisation bemerkt das der User des Nextcloud Shares nicht.

Der Vorteil dieser Methode ist, dass beide Container unabhängig voneinander laufen können, ohne dass Berechtigungen direkt synchronisiert werden müssen.

Backup der Dokumente

Für ein Backup der exportierten Dokumente aus Paperless nutze ich den folgenden Befehl:

podman exec -ti dmsserver_webserver_1 document_exporter ../export

Hierbei wird der document_exporter von Paperless aufgerufen, um die Dokumente in das angegebene Verzeichnis zu exportieren.

Wichtig: Wenn Dokumente von Nextcloud in das Paperless-Archiv verschoben (nicht kopiert) werden, sind sie nicht mehr im Datenbestand von Nextcloud verfügbar. Daher ist eine regelmäßige Datensicherung beider Datenbestände (Nextcloud und Paperless) essenziell.

Synchronisation in Nextcloud

Die Verzeichnissynchronisation in Nextcloud erfolgt über einen Crontab-Job, der den folgenden Befehl ausführt:

podman exec -u 33 nextcloud ./occ files:scan archiv

Dabei ist zu beachten:

Der Benutzer archiv in Nextcloud teilt die relevanten Verzeichnisse.

Der OCC-Scan bezieht sich ausschließlich auf die FTP-Shares. Dies beschleunigt die Synchronisation erheblich.

Ein vollständiger Scan der Verzeichnisse eines normalen Nutzers würde ungefähr 5 Minuten dauern.

Fazit

Die Kombination von Paperless-NGX und Nextcloud bietet eine leistungsfähige Lösung für Dokumentenmanagement und -archivierung. Mit dem Umweg über einen FTP-Server konnten Berechtigungsprobleme elegant umgangen werden, ohne die Flexibilität der beiden Systeme einzuschränken.

Weitere Optimierungen sind möglich, insbesondere wenn die beiden Container zukünftig mit einer einheitlichen Benutzer-ID betrieben werden.

Stichworte

Nextcloud, Paperless-NGX, Docker, Podman, FTP, vsftpd, UID, USERMAP, OCC

synchronisierung

Anonymous (anonymous@undisclosed.example.com) — 2026-05-03T06:47:05+00:00

Tips fuer Nextcloud

Manual zur Nutzung von OCC

Nextcloud laeuft in einem rootless Container. Der Nutzer im Container ist mit entsprechender UID anzugeben. www-data ist es auf Metall

Fehler UNIX Time 0

Der Befehl

find Nextcloud/ ! -newermt „@86400“ -exec touch {} \;

sucht nach Dateien, die nicht neuer sind als der Zeitstempel @86400. Das bedeutet:

! -newermt „@86400“ filtert Dateien, die nicht neuer sind als 86400 Sekunden nach der Epoche (1. Januar 1970, 00:00:00 UTC). Mit anderen Worten: Es werden Dateien ausgewählt, die entweder am oder vor dem 2. Januar 1970, 00:00:00 UTC erstellt wurden.

Falls es tatsächlich Dateien gibt, die vor diesem sehr frühen Datum erstellt wurden, würde der Befehl den Zeitstempel dieser Dateien mit dem touch-Befehl auf die aktuelle Zeit setzen. Es scheint, ich vermute, das es sich hierbei um einen Bug handelt der so ueberlistet wird.

Anschliessend sollte ein Rescan durch Nextcloud den Fehler beheben.

podman exec -u 33 nextcloud ./occ files:scan Thomas

Stichworte

Nextcloud, OCC, files:scan, rootless, Container, Unix-Zeit

upgrade

Anonymous (anonymous@undisclosed.example.com) — 2026-05-03T06:46:40+00:00

Upgrade einer Nextcloud Docker-Instanz mit Podman (rootless)

Das Upgrade einer rootless Nextcloud-Instanz mit Podman kann im Wartungsmodus hängen bleiben. Die Weboberfläche scheitert oft. Hier die Lösung:

1. Upgrade starten

Das Upgrade über die WebApp starten. Falls Nextcloud im Wartungsmodus hängen bleibt, fortfahren:

2. Upgrade über Kommandozeile abschließen

podman exec -u www-data nextcloud ./occ upgrade

3. Wartungsmodus deaktivieren

Sollte nach dem Upgrade automatisch erfolgen!

podman exec -u www-data nextcloud ./occ maintenance:mode --off

4. Überprüfung

Erfolgreiches Upgrade in der WebApp prüfen.

Upgrade Nextcloud Docker mit Podman

Hier ist eine Anleitung, wie man ein Upgrade der Nextcloud-Instanz durchführt, die mit Podman verwaltet wird.

Schritte zum Upgrade

1. Ziehen des neuesten Images Zunächst wird das neueste Nextcloud-Image aus dem Docker-Hub heruntergeladen:

podman pull docker.io/library/nextcloud:latest

2. Stoppen des laufenden Containers Der aktuell laufende Nextcloud-Container muss gestoppt werden:

podman container stop nextcloud

3. Löschen des alten Containers Der alte Container wird entfernt, um Platz für den neuen zu schaffen:

podman container rm nextcloud

4. Starten des neuen Containers Schließlich wird ein neuer Container mit dem aktualisierten Image erstellt und gestartet:

podman run -d --name nextcloud -p 8082:80 -v ./nextcloud:/var/www/html docker.io/library/nextcloud

Wichtige Hinweise

* Datenvolumen beibehalten: Stelle sicher, dass das Volumen (z. B. `./nextcloud`) korrekt eingebunden ist, um die Daten persistent zu halten.

* Port-Änderungen: Überprüfe, ob der verwendete Port (`8082:80`) in deiner Umgebung frei ist.

* Backup: Vor dem Upgrade sollte immer ein vollständiges Backup der Daten und der Datenbank gemacht werden.

Nützliche Links

* Offizielle Nextcloud Docker-Dokumentation

* Podman Dokumentation

Stichworte

Nextcloud, Podman, Docker, Upgrade, occ, Wartungsmodus, rootless