Paperless-ngx, Teil 9: Update durchführen
Heute ist die Version 2 von Paperless-ngx erschienen. Über etliche der neuen Funktionen hatte ich bereits berichtet. Sofern man die Installation so durchgeführt hat, wie in dieser Reihe beschrieben, ist das Update ein Kinderspiel. Trotzdem lohnt sich immer ein Backup – man kann ja nie wissen.
Inhalt
Drei Befehle genügen
Die Kommandozeile ist inzwischen ja schon ein alter Bekannter. Also: diese aufrufen und zunächst ins Paperless-ngx-Verzeichnis wechseln mit „cd paperless-ngx“. Hier nun die folgenden Befehle ausführen:
1. Paperless-ngx stoppen
Natürlich müssen wir laufende Prozesse kurz stoppen, damit beim Update nichts durcheinander kommt. Der Befehl hierfür:
sudo docker-compose downWebserver und andere Dienste werden angehalten, dieser Vorgang dauert auf einem Raspberry Pi 4 ca. 20 bis 30 Sekunden.
2. Neue Version abrufen
Download, Einrichtung der neuen Version und Update der vorhandenen Daten erfolgt über einen einzigen Befehl:
sudo docker-compose pullJe nach Archivgröße und Internetverbindung kann dieser Vorgang einige Minuten dauern. Nicht ungeduldig werden, auch wenn sich zwischendurch auf der Kommandozeile nichts tut. Espresso holen und abwarten, bis das gewohnte Prompt der Kommandozeile wieder erscheint.
3. Docker wieder starten
So, nun der letzte Schritt, damit der Webserver von Paperless-ngx wieder anspringt:
sudo docker-compose up -dDas kann jetzt noch einmal einige Zeit dauern. Abwarten. Nicht immer erscheint automatisch wieder das Prompt-Zeichen. Einfach über den Browser mal Paperless-ngx aufrufen und schauen, ob alles funktioniert. Fertig.
Jetzt sollten die neuen Menüpunkte zusammen mit den übernommenen Dokumenten erscheinen.
Bisherige Teile der Paperless-ngx-Serie:
Teil 1: Ausführlicher Überblick
Teil 2: Suche & Tags
Teil 3: consume-Ordner – Einsatz von Scannern
Teil 4: Speicherpfade konfigurieren
Teil 5: Installation auf dem Raspberry Pi
Teil 6: Neue Funktionen in Version 2
Teil 7: Dokumente unterwegs über das eigene Modem abrufen
Teil 8: Exportfunktion nutzen
Teil 9: Update durchführen
Teil 10: Das Rundum-sorglos-Backup
Teil 11: Mail-Abruf mit vielen Extras
Teil 12: Mein Alltag mit Paperless-ngx
Teil 13: Ein Quanten-Code für das Papier-Archiv
Teil 14: Automatisierte Ablage auf Speicherpfaden
Teil 15: Neue Funktion für das Verbinden und Trennen von Dokumenten
Teil 16: Dashboard, smarte Widgets und erweiterte Ansichten
Teil 17: Unterordner des consume-Verzeichnisses nutzen
Teil 18: Paperless-ngx auf Synology/NAS ohne Docker nutzen
Teil 19: Praxisbeispiel – kleine Hausverwaltung
Teil 20: Dokumente per Mail aus dem Heimnetz versenden
Teil 21: Die 1-Klick-Sicherung mit allem Drum und Dran
Das könnte dich ebenfalls interessieren
Mehr machen mit Linux Mint. Teil 1: Einführung
Vorschau für PDF-Dateien nutzen (Windows)
17 Kommentare
Henrik
Moin,
vielen Dank für die tollen Tutorials. Echt aufwändig und gut gemacht. Vielen Dank dafür!
Ich habe leider erst zu spät von Deiner Raspberry-Installation gelesen und sie „herkömmlich“ durchgeführt. Das war auch so weit so erfolgreich.
Jetzt möchte ich die Installation von 1.7 auf 2 updaten. Leider scheiter ich. Ich konnte mit ein wenig Aufwand von 1.17.1 auf 1.17.4 updaten.
Wenn ich dann aber über die Konsole den Prozess anstoße, um auf die aktuelle 2er Version zu aktualisieren, bekomme ich folgende Fehlermeldung:
tika wird noch grün, broker, db und gotenberg werden rot und werfen einen „error“ raus. Der Webserver bleibt auf „Pulling“. Der ganze Prozess wird mit „no matching manifest for linux/arm/v8 in the manifest list entries“ abgebrochen.
Habe ich das Problem exklusiv? Was mach ich falsch?
Zur Not ziehe ich ein Backup und spiel die Dokumente manuell in eine neue 2er-Installation. Da die Datenbanken nicht übereinstimmen, funktioniert ein Export/Import leider nicht …
Danke Dir für Deine Zeit und Hilfe,
Henrik
Herbert
Bevor man sehr viel Zeit mit einer Fehlersuche verbringt, probiere mal auf einer zweiten microSD: 1. aktuelles Raspberry Pi OS 64-Bit aufspielen und kurz Paperless-ngx 2.0 so installieren, wie hier beschrieben. 2. Trotzdem probieren, den Export von 1.7 zu importieren. Das System meckert dann zwar, kann aber gut sein, dass es trotzdem importiert.
Zweite Möglichkeit: tika und gotenberg zunächst in der yml-Datei „abschalten“ und schauen, ob es ohne installiert wird. Falls ja, kannst Du die später wieder anschalten.
Der Rest wäre Fehlersuche, die man dann noch mal schauen kann.
Hardy Heron
Hi!
nach einem Update von Version 2.6.2 auf die aktuelle Version komme ich nicht mehr auf die Web GUI.
Die Fehlermeldung Error Connection Refused erscheint.
Was mache ich hier falsch?
Die Konsolenausgabe sagt, dass alles i.O. ist.
Auch der Port 8000 welchen ich verwende ist wohl offen.
Herbert
Lässt sich so schwer sagen. Hast Du mal „sudo docker-compose down“ und anschließend „sudo docker-compose up“ versucht? Bei dem zweiten Befehl erkennst Du im Terminal, ob alle Dienste gestartet werden.
Max Kumbach
Hallo
möchte mich ganz herzlich für die Anleitung bedanken hatt sehr gut geklappt.
LG max
Hans-Peter Herkenrath
Hallo Herbert, ganz herzlichen Dank für den tollen Blog. Er hat mir sehr viele Tips zum optimalen Gebrauch vo ppl-ngx gegeben.
Angefangen habe ich mit Version 2.12; mittlerweile läuft 2.13.1 (seit heute). Bei mir läuft es auf einem Synology-Nas DS918+ in einem Docker-Container.
Ich wollte nur noch einen Hinweis geben, das man für das Update aller Docker-Container „Watchtower“ als zusätzlichen Container installieren kann. Dann muss man sich um die Updates nicht mehr kümmern. Watchtower erledigt dies vollautomatisch. Be ppl muss man sich, wenn der Hinweis unten links auf ein neues Update erscheint, für einige Zeit aus ppl abmelden.
Wie man Watchtower installiert ist z.B. hier beschrieben:
https://mariushosting.com/how-to-install-watchtower-on-your-synology-nas/
Viele Grüße Hans-Peter
Herbert
Danke für die nette Rückmeldung und den Hinweis auf Watchtower! Ich selbst setze zwar Watchtower nicht ein, um mein System möglichst schlank zu halten (und habe mir ein Update-Skript geschrieben) – ist aber auf jeden Fall seine sehr gute Empfehlung, wenn man viele Docker-Sachen installiert hat!
Thomas
Servus!
Vielen Dank für die wirklich gute Beschreibung rund um paperless! Für mich als Neuling ist das alles sehr hilfreich!
ich wollte jetzt das erste update auf dem raspberry von 2.13.5 auf die aktuelle version durchführen, und bekomme folgende meldung beim runterladen beim Abrufen der neuen Version:
admin@paperpi:~/paperless-ngx $ sudo docker-compose pull
Pulling broker … error
Pulling db … done
Pulling webserver … done
ERROR: for broker Get „https://registry-1.docker.io/v2/“: dial tcp: lookup registry-1.docker.io on [fe80::1%wlan0]:53: read udp [fe80::e755:6128:3293:6665%wlan0]:43563->[fe80::1%wlan0]:53: i/o timeout
ERROR: Get „https://registry-1.docker.io/v2/“: dial tcp: lookup registry-1.docker.io on [fe80::1%wlan0]:53: read udp [fe80::e755:6128:3293:6665%wlan0]:43563->[fe80::1%wlan0]:53: i/o timeout
Herbert
Könnte ein DNS-Problem sein. Mach‘ mal ein Backup Deiner SD-Karte und dann probiere:
sudo nano /etc/dhcpcd.conf
static domain_name_servers=1.1.1.1 8.8.8.8
sudo systemctl restart docker
docker-compose pull
Edwin
Vielen Dank! Das ist schon fast kein Blog sondern ein Wiki. Hier sind einfach so viele hilfreiche Tipps. Erst war nur ein Kapitel für mich interessant, nun bin ich schon zum x-ten mal hier. Einfach toll! Du solltest für die offizielle Doku arbeiten 😉
Auch möchte hier meine Erfahrung mit dem Pi 3b+ (1GB RAM) teilen. Es gab immer wieder Lags, trotz versuchter Optimierung von Memory- und Thread-Nutzung. So versagte dann mein Pi-Hole zeitweise. Bin nun auf einen ThinClient mit OpenMediaVault umgezogen. Viel erfolg allen und LG
Herbert
Danke für die nette Rückmeldung! Dann weiterhin viel Spaß mit dem Programm!
Egbert Gertz
Hallo,
vielen Dank für diese NGX-Serie. Bin durch Zufall auf diese Software gestoßen. Da ich einen Proxmox-Server am Laufen habe (Hausautomatisierung), lag es nahe, NGX als Container anzulegen. Dazu noch eine externe Platte an den Container durchgereicht. Das System läuft stabil, ist in die Backuproutine des Backupservers mit eingebunden. So nach und nach lasse ich alle meine Versicherungsverträge usw. einlesen. Habe dem Container 8 GB Ram zugewiesen und 4 Kerne. Läuft stabil, ohne Probleme. Auch ein Update auf eine neue Version hat ohne Probleme geklappt. Vielen Dank für Deine Bemühungen, uns das so einfach wie möglich zu machen.
Herbert
Danke für die Schilderung Deines Settings!
Jörg Müller
Guten Abend,
habt ihr vielleich einen Tipp für mich?
Ich habe Paperless ngx mit Docker auf einem Windows 11 PC laufen.
Nun habe ich wie oben beschrieben ein Update durchgeführt.
Wenn ich in der Powershell die Version abfrage, erscheint dort auch die in Guthub gelistete aktuelle Version, wenn ich jedoch Paperless NGX über den Browser aufrufe erscheint links unten weiterhin die ursprünglich installierte Version.
In der Datei docker-compose.yml steht u.a.
“ webserver:
image: ghcr.io/paperless-ngx/paperless-ngx:latest“
Im Web habe ich gelesen, man solle dieses „latest“ durch die neue Versionsnummer ersetzen?
Hatte jemand ähnliche Probleme und kann mir sagen, ob das mit dem Tipp etwas bringt?
Vielleicht habt ihr ja auch einen anderen Tipp für mich…
Lieben Dank.
Herbert
Vielleicht ist da noch was im Cache. Starte mal Deinen Computer neu.
René
Hallo
Vielen Dank für diue tolle Seite – das ist die beste Anleitung für die paperless Installation die ich finden konnte.
Die Updates funktionieren bei mir wunderbar und sind mit den drei Befehlen einfach umzusetzen.
Muss man danach noch irgendwelce Daten löschen? Ich hab das Gefühl, dass sich die Installation aufbläht. Mit 400 Dokumenten bin ich „schon“ bei 12GB.
Danke für die Mühe
René
Herbert
Danke für die nette Rückmeldung! Man muss nach einem Update eigentlich nichts löschen. Unabhängig vom Update sollte man den Export-Ordner im Auge behalten. Wenn man dort eine automatische Sicherung eingerichtet hat, kann es sein, dass man alte Sicherungen löschen muss.