{"id":2911,"date":"2025-07-20T16:00:43","date_gmt":"2025-07-20T14:00:43","guid":{"rendered":"https:\/\/digital-cleaning.de\/?p=2911"},"modified":"2025-07-20T16:00:45","modified_gmt":"2025-07-20T14:00:45","slug":"paperless-ngx-teil-22-update-der-datenbank-super-simpel","status":"publish","type":"post","link":"https:\/\/digital-cleaning.de\/index.php\/paperless-ngx-teil-22-update-der-datenbank-super-simpel\/","title":{"rendered":"Paperless-ngx, Teil 22: Update der Datenbank – super-simpel"},"content":{"rendered":"\n

Bei einer Standard-Installation von Paperless-ngx werden die Daten in einer PostgreSQL-Datenbank gespeichert. \u00dcber lange Zeit wurde daf\u00fcr PostgreSQL in der Version 15 benutzt. <\/strong>Damit klappen Paperless-ngx-Updates zwar auch weiterhin, aber in der n\u00e4chsten Zeit sollte man doch auf die aktuelle Version 17 von PostgreSQL umsteigen. Diese Empfehlung hat die Paperless-ngx-Community in den letzten Monaten etwas verwirrt, weil ein Datenbank-Update etwas komplexere Anforderungen stellt. So sind wieder zahlreiche YouTube-Videos entstanden mit komplizierten Erkl\u00e4rungen, die eher abschrecken. Das ist unn\u00f6tig – denn es gibt einen sehr einfachen sauberen Weg, die Aktualisierung ohne Datenverlust durchzuf\u00fchren. Die Sache ist in 5 Minuten erledigt – und schon betreibt man sein Paperless-ngx mit PostgreSQL 17. <\/strong>Aber wie immer gilt: Zuvor ein Backup durchf\u00fchren!<\/p>\n\n\n\n

Vorbereitung in zwei Schritten<\/h2>\n\n\n\n

1. Export-Befehl<\/h3>\n\n\n\n

Zun\u00e4chst f\u00fchrt man den Export-Befehl durch, um den aktuellen Datenbestand samt Einstellungen, Nutzerkonten, Tags, Speicherpfaden usw. mit einem Klick zu sichern. Bei der Docker-Compose-Installation, die ich f\u00fcr den Raspberry Pi vorgeschlagen habe, sieht der Befehl so aus (evtl. zuvor „docker compose down“):<\/p>\n\n\n\n

<\/path><\/path><\/svg><\/span>
docker compose exec <\/span>-<\/span>T webserver document_exporter ..<\/span>\/export<\/span> <\/span>-<\/span>z<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
Diesen Befehl gibt man im Verzeichnis „home\/pi\/paperless-ngx“ im Terminal ein (oder erledigt es \u00fcber SSH) – die exportierten Dateien sind anschlie\u00dfend unter „home\/pi\/paperless-ngx\/export“ zu finden.<\/p>\n\n\n\n
2. Verzeichnis umbenennen<\/h3>\n\n\n\n
Jetzt das Verzeichnis umbenennen, z. B. in „paperless-ngx_alt“. Fertig. Kein neues Verzeichnis anlegen – das erledigt das Installationsskript automatisch.<\/p>\n\n\n
\n
\"\"<\/a><\/figure><\/div>\n\n\n
Blanko-Installation von Paperless-ngx <\/h2>\n\n\n\n
Nun im Terminal den Befehl f\u00fcr eine Neu-Installation von Paperless-ngx eingeben und die Fragen beantworten (Schritt-f\u00fcr-Schritt-Anleitung in Teil 5<\/a><\/strong> der Artikelserie – statt „docker-compose“ heute „docker compose“ ohne Bindestrich nutzen). Es wird dadurch wieder ein Verzeichnis „paperless-ngx“ angelegt. In der „docker-compose.yml“-Datei kann man ersehen, dass nun PostgreSQL 17 verwendet wird:<\/p>\n\n\n
\n
\"\"<\/a><\/figure><\/div>\n\n\n
Kurz starten mit „docker compose up -d“ und im Browser aufrufen – die aktuellste Version von Paperless-ngx sollte nun zu sehen sein. Jetzt noch den Import-Befehl ausf\u00fchren. Dazu die durch den Export-Befehl gesicherten Dateien auf den leeren Export-Pfad des neuen Paperless-ngx entpacken. Anschlie\u00dfend im Pfad „\/home\/pi\/paperless-ngx“ den Import-Befehl ausf\u00fchren. Achtung: Diesmal nicht vorher „docker compose down“ ausf\u00fchren! <\/p>\n\n\n\n
<\/path><\/path><\/svg><\/span>
docker compose exec webserver document_importer ..<\/span>\/export<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
Wahrscheinlich gibt es eine kleine Warnung, dass bereits ein Nutzer angelegt wurde. Dieser wird durch den Import mit den bisherigen Account-Daten \u00fcberschrieben – das ist ja immer so beim Import.<\/p>\n\n\n\n
Okay – erledigt. Wenn man nun Paperless-ngx aufruft, sind die Dokumente wieder alle da, man nutzt die aktuellste Paperless-ngx-Version samt der aktuellen PostgreSQL-Version 17.<\/p>\n\n\n\n
Hinweise<\/h2>\n\n\n\n
Wenn man Paperless-ngx mit komplexen Skripten und Arbeitsabl\u00e4ufen modifiziert hat – etwa bei Umgebungsvariablen oder mit zus\u00e4tzlichen Post-Skripten -, dann muss man diese Erg\u00e4nzungen evtl. noch mal neu einrichten. Bei mir lief alles unproblematisch – aber da muss jeder selbst entscheiden, ob das die richtige Methode f\u00fcr ihn ist. Backups sind ja eine Selbstverst\u00e4ndlichkeit – darauf bin ich in einigen Artikeln der Serie eingegangen. Zudem kann man vorher einen Testlauf durchf\u00fchren: Ich habe immer eine Parallel-Installation auf meinem Raspberry Pi 4. Bevor ich meine Hauptinstallation auf dem Raspberry Pi 5 \u00e4ndere, probiere ich in dieser Testinstallation alles aus. Wer keinen zweiten Server zur Hand hat, der kann das auch vorab auf seinem Linux-Desktop-Rechner ausprobieren (sogar unter Windows sind Docker-Installationen m\u00f6glich).<\/p>\n\n\n\n
Bisherige Teile der Paperless-ngx-Serie:<\/strong><\/p>\n\n\n\n
Teil 1: Ausf\u00fchrlicher \u00dcberblick<\/a><\/strong>
Teil 2: Suche & Tags<\/a><\/strong>
Teil 3: consume-Ordner – Einsatz von Scannern<\/a><\/strong>
Teil 4: Speicherpfade konfigurieren<\/strong><\/a>
Teil 5: Installation auf dem Raspberry Pi<\/strong><\/a>
Teil 6: Neue Funktionen in Version 2<\/a><\/strong>
Teil 7: Dokumente unterwegs \u00fcber das eigene Modem abrufen<\/a><\/strong>
Teil 8: Exportfunktion nutzen<\/a><\/strong>
Teil 9: Update durchf\u00fchren<\/a><\/strong>
Teil 10: Das Rundum-sorglos-Backup<\/a><\/strong>
Teil 11: Mail-Abruf mit vielen Extras<\/a><\/strong>
Teil 12: Mein Alltag mit Paperless-ngx<\/a><\/strong>
Teil 13: Ein Quanten-Code f\u00fcr das Papier-Archiv<\/a><\/strong>
Teil 14: Automatisierte Ablage auf Speicherpfaden<\/a><\/strong>
Teil 15: Neue Funktion f\u00fcr das Verbinden und Trennen von Dokumenten<\/a><\/strong>
Teil 16: Dashboard, smarte Widgets und erweiterte Ansichten<\/strong><\/a>
Teil 17: Unterordner des consume-Verzeichnisses nutzen<\/a><\/strong>
Teil 18: Paperless-ngx auf Synology\/NAS ohne Docker nutzen<\/strong><\/a>
Teil 19: Praxisbeispiel \u2013 kleine Hausverwaltung<\/strong><\/a>
Teil 20: Dokumente per Mail aus dem Heimnetz versenden<\/strong><\/a>
Teil 21: Die 1-Klick-Sicherung mit allem Drum und Dran<\/a><\/strong>
Teil 22: Update der Datenbank – super-simpel<\/a><\/strong>
Teil 23: Neuer PDF-Editor<\/a><\/strong>
Teil 24: Der Mega-All-in-One-Befehl f\u00fcr die Sofortinstallation<\/a><\/strong>
Teil 25: Der Briefmarken-PC f\u00fcr die Weitergabe<\/a><\/strong><\/p>\n","protected":false},"excerpt":{"rendered":"
Bei einer Standard-Installation von Paperless-ngx werden die Daten in einer PostgreSQL-Datenbank gespeichert. \u00dcber lange Zeit wurde daf\u00fcr PostgreSQL in der Version 15 benutzt. Damit klappen Paperless-ngx-Updates zwar auch weiterhin, aber in der n\u00e4chsten Zeit sollte man doch auf die aktuelle Version 17 von PostgreSQL umsteigen. Diese Empfehlung hat die Paperless-ngx-Community in den letzten Monaten etwas verwirrt, weil ein Datenbank-Update etwas komplexere Anforderungen stellt. So sind wieder zahlreiche YouTube-Videos entstanden mit komplizierten Erkl\u00e4rungen, die eher abschrecken. Das ist unn\u00f6tig – denn es gibt einen sehr einfachen sauberen Weg, die Aktualisierung ohne Datenverlust durchzuf\u00fchren. Die Sache ist in 5 Minuten erledigt – und schon betreibt man sein Paperless-ngx mit PostgreSQL 17. Aber wie immer gilt: Zuvor ein Backup durchf\u00fchren! Vorbereitung in zwei Schritten 1. Export-Befehl Zun\u00e4chst f\u00fchrt man den Export-Befehl durch, um den aktuellen Datenbestand samt Einstellungen, Nutzerkonten, Tags, Speicherpfaden usw. mit einem Klick zu sichern. Bei der Docker-Compose-Installation, die ich f\u00fcr den Raspberry Pi vorgeschlagen habe, sieht der Befehl so aus (evtl. zuvor „docker compose down“): Diesen Befehl gibt man im Verzeichnis „home\/pi\/paperless-ngx“ im Terminal ein (oder erledigt es \u00fcber SSH) – die exportierten Dateien sind anschlie\u00dfend unter „home\/pi\/paperless-ngx\/export“ zu finden. 2. Verzeichnis umbenennen Jetzt das Verzeichnis umbenennen, z. B. in „paperless-ngx_alt“. Fertig. Kein neues Verzeichnis anlegen – das erledigt das Installationsskript automatisch. Blanko-Installation von Paperless-ngx Nun im Terminal den Befehl f\u00fcr eine Neu-Installation von Paperless-ngx eingeben und die Fragen beantworten (Schritt-f\u00fcr-Schritt-Anleitung in Teil 5 der Artikelserie – statt „docker-compose“ heute „docker compose“ ohne Bindestrich nutzen). Es wird dadurch wieder ein Verzeichnis „paperless-ngx“ angelegt. In der „docker-compose.yml“-Datei kann man ersehen, dass nun PostgreSQL 17 verwendet wird: Kurz starten mit „docker compose up -d“ und im Browser aufrufen – die aktuellste Version von Paperless-ngx sollte nun zu sehen sein. Jetzt noch den Import-Befehl ausf\u00fchren. Dazu die durch den Export-Befehl gesicherten Dateien auf den leeren Export-Pfad des neuen Paperless-ngx entpacken. Anschlie\u00dfend im Pfad „\/home\/pi\/paperless-ngx“ den Import-Befehl ausf\u00fchren. Achtung: Diesmal nicht vorher „docker compose down“ ausf\u00fchren! Wahrscheinlich gibt es eine kleine Warnung, dass bereits ein Nutzer angelegt wurde. Dieser wird durch den Import mit den bisherigen Account-Daten \u00fcberschrieben – das ist ja immer so beim Import. Okay – erledigt. Wenn man nun Paperless-ngx aufruft, sind die Dokumente wieder alle da, man nutzt die aktuellste Paperless-ngx-Version samt der aktuellen PostgreSQL-Version 17. Hinweise Wenn man Paperless-ngx mit komplexen Skripten und Arbeitsabl\u00e4ufen modifiziert hat – etwa bei Umgebungsvariablen oder mit zus\u00e4tzlichen Post-Skripten -, dann muss man diese Erg\u00e4nzungen evtl. noch mal neu einrichten. Bei mir lief alles unproblematisch – aber da muss jeder selbst entscheiden, ob das die richtige Methode f\u00fcr ihn ist. Backups sind ja eine Selbstverst\u00e4ndlichkeit – darauf bin ich in einigen Artikeln der Serie eingegangen. Zudem kann man vorher einen Testlauf durchf\u00fchren: Ich habe immer eine Parallel-Installation auf meinem Raspberry Pi 4. Bevor ich meine Hauptinstallation auf dem Raspberry Pi 5 \u00e4ndere, probiere ich in dieser Testinstallation alles aus. Wer keinen zweiten Server zur Hand hat, der kann das auch vorab auf seinem Linux-Desktop-Rechner ausprobieren (sogar unter Windows sind Docker-Installationen m\u00f6glich).<\/p>\n","protected":false},"author":1,"featured_media":2920,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[],"class_list":["post-2911","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-allgemein"],"_links":{"self":[{"href":"https:\/\/digital-cleaning.de\/index.php\/wp-json\/wp\/v2\/posts\/2911","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/digital-cleaning.de\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/digital-cleaning.de\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/digital-cleaning.de\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/digital-cleaning.de\/index.php\/wp-json\/wp\/v2\/comments?post=2911"}],"version-history":[{"count":3,"href":"https:\/\/digital-cleaning.de\/index.php\/wp-json\/wp\/v2\/posts\/2911\/revisions"}],"predecessor-version":[{"id":3215,"href":"https:\/\/digital-cleaning.de\/index.php\/wp-json\/wp\/v2\/posts\/2911\/revisions\/3215"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/digital-cleaning.de\/index.php\/wp-json\/wp\/v2\/media\/2920"}],"wp:attachment":[{"href":"https:\/\/digital-cleaning.de\/index.php\/wp-json\/wp\/v2\/media?parent=2911"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/digital-cleaning.de\/index.php\/wp-json\/wp\/v2\/categories?post=2911"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/digital-cleaning.de\/index.php\/wp-json\/wp\/v2\/tags?post=2911"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}