Paperless-ngx auf Synology-DiskStations - Versionsgeschichte

JohneDoe: Backup hinzugefügt

2025-03-22T16:57:25Z

Backup hinzugefügt

← Nächstältere Version		Version vom 22. März 2025, 16:57 Uhr
Zeile 145:		Zeile 145:

	Danach solltet ihr euch mit den bekannten Anmeldedaten wieder anmelden können. Wird die Anmeldeseite geladen, funktioniert das Anmelden aber nicht mit Verweis auf falsche Anmeldedaten, dann hat das zurückspielen der Datenbank nicht funktioniert.		Danach solltet ihr euch mit den bekannten Anmeldedaten wieder anmelden können. Wird die Anmeldeseite geladen, funktioniert das Anmelden aber nicht mit Verweis auf falsche Anmeldedaten, dann hat das zurückspielen der Datenbank nicht funktioniert.

			=== Backup ===
			Es reicht nicht aus, dass man den Ordner mit den Dokumenten und der Datenbank sichert, weil man dabei immer eine korrupte Datenbank bekommen könnte. Dies passiert in dem z.B. zu dem Zeitpunkt vom kopieren der Daten noch etwas in die Datenbank geschrieben wird. Daher sollte man immer einen Datenbank Dump erzeugen. Um den Dump zu erzeugen geht ihr genau so vor wie vor einem DB Update. Einfach regelmäßig erzeugen und mit eurem Backup mit sichern.

	=== Zusätzliche Links ===		=== Zusätzliche Links ===

JohneDoe: In der Docker Compose Datei werden keine Docker Volumes verwendet. Dann müssen diese auch nicht erstellt werden. Ansonsten erzeugt Docker Volumes im Systemordner die nie verwendet werden. Ist zwar nicht schlimm, aber einfach unschön.

2025-03-20T15:04:30Z

In der Docker Compose Datei werden keine Docker Volumes verwendet. Dann müssen diese auch nicht erstellt werden. Ansonsten erzeugt Docker Volumes im Systemordner die nie verwendet werden. Ist zwar nicht schlimm, aber einfach unschön.

← Nächstältere Version		Version vom 20. März 2025, 15:04 Uhr
Zeile 90:		Zeile 90:
	PAPERLESS_REDIS: redis://broker:6379		PAPERLESS_REDIS: redis://broker:6379
	PAPERLESS_DBHOST: db		PAPERLESS_DBHOST: db

	~~volumes:~~
	~~data:~~
	~~media:~~
	~~pgdata:~~
	~~redisdata:~~
	</syntaxhighlight>Sehr wichtig ist es hier, die Version der Datenbank festzuschreiben, wenn ihr Postgres verwendet. Solltet ihr die Version hier nicht festlegen, zumindest auf die Hauptversion, dann wird es bei einem Wechsel auf die nächste Hauptversion, nach meiner Anleitung wäre das Version 16, dazu kommen, dass die Datenbank nicht mehr erreichbar ist. Da müsst ihr wirklich aufpassen. Im schlimmsten Fall zerschießt ihr euch die komplette Datenbank. Und wenn ihr dann keine Sicherung habt, dann könnt ihr die ganze Installation neu aufsetzen. Auch bei Paperless gilt, Backup ist Trumpf!		</syntaxhighlight>Sehr wichtig ist es hier, die Version der Datenbank festzuschreiben, wenn ihr Postgres verwendet. Solltet ihr die Version hier nicht festlegen, zumindest auf die Hauptversion, dann wird es bei einem Wechsel auf die nächste Hauptversion, nach meiner Anleitung wäre das Version 16, dazu kommen, dass die Datenbank nicht mehr erreichbar ist. Da müsst ihr wirklich aufpassen. Im schlimmsten Fall zerschießt ihr euch die komplette Datenbank. Und wenn ihr dann keine Sicherung habt, dann könnt ihr die ganze Installation neu aufsetzen. Auch bei Paperless gilt, Backup ist Trumpf!

Monacum: /* Das „leidige“ Thema PostgreSQL-Updates… */ Ebenen angepasst

2025-03-07T07:06:10Z

Das „leidige“ Thema PostgreSQL-Updates…: Ebenen angepasst

← Nächstältere Version		Version vom 7. März 2025, 07:06 Uhr
Zeile 115:		Zeile 115:
	Wenn alles geklappt hat, findet Ihr nach der Anleitung oben Paperless unter <code><nowiki>http://domain:34343</nowiki></code>. Den Port 34343 könnt Ihr logischerweise anpassen.		Wenn alles geklappt hat, findet Ihr nach der Anleitung oben Paperless unter <code><nowiki>http://domain:34343</nowiki></code>. Den Port 34343 könnt Ihr logischerweise anpassen.

	==== Das „leidige“ Thema PostgreSQL-Updates… ====		=== Das „leidige“ Thema PostgreSQL-Updates… ===

	===== Grundsätzliches =====		==== Grundsätzliches ====
	Immer wieder wird die Frage gestellt, wie im Zusammenhang mit Paperless-ngx eine Datenbankversion aktualisiert werden kann nach einem Major Update, wenn als Datenbank PostgreSQL zum Einsatz kommt. Da der ganze Vorgang nicht trivial ist und ich bei meinem Update von Version 15 auf 16 die eine oder andere Hürde gefunden habe, für die ich mir diverse Tips hier zusammengesucht habe nunmehr ein Versuch, das ganze in einer ausführlichen Anleitung zusammenzufassen.		Immer wieder wird die Frage gestellt, wie im Zusammenhang mit Paperless-ngx eine Datenbankversion aktualisiert werden kann nach einem Major Update, wenn als Datenbank PostgreSQL zum Einsatz kommt. Da der ganze Vorgang nicht trivial ist und ich bei meinem Update von Version 15 auf 16 die eine oder andere Hürde gefunden habe, für die ich mir diverse Tips hier zusammengesucht habe nunmehr ein Versuch, das ganze in einer ausführlichen Anleitung zusammenzufassen.

Zeile 130:		Zeile 130:
	Wer erst mit Paperless-ngx startet, dem sei auch empfohlen, von Beginn an auf MariaDB als Datenbank zu setzen; wer bisher PostgreSQL einsetzt und gerne auf MariaDB wechseln möchte, dem sei diese Anleitung von @Adama ans Herz gelegt: Paperless-ngx: Migration Postgresql zu MariaDB. Bei großen Versionsupdates der MariaDB sind hier im Forum bisher keine Probleme bekannt und das im Vergleich umständliche Prozedere unten entfällt.		Wer erst mit Paperless-ngx startet, dem sei auch empfohlen, von Beginn an auf MariaDB als Datenbank zu setzen; wer bisher PostgreSQL einsetzt und gerne auf MariaDB wechseln möchte, dem sei diese Anleitung von @Adama ans Herz gelegt: Paperless-ngx: Migration Postgresql zu MariaDB. Bei großen Versionsupdates der MariaDB sind hier im Forum bisher keine Probleme bekannt und das im Vergleich umständliche Prozedere unten entfällt.

	====~~= Grundlagen =~~====		==== Grundlagen ====
	Bevor ich beginne, möchte ich ein paar Begriffe klären, damit es nachher nicht zu Missverständnissen kommt bzw. ihr wisst, was ihr wo mit eventuell anderen Bezeichnungen ersetzen müsst.		Bevor ich beginne, möchte ich ein paar Begriffe klären, damit es nachher nicht zu Missverständnissen kommt bzw. ihr wisst, was ihr wo mit eventuell anderen Bezeichnungen ersetzen müsst.

Zeile 138:		Zeile 138:
	Dann möchte ich grundsätzlich anmerken, dass ich die ganzen Befehle in der Regel über mein Terminal absetze, weil ich dort sofort das Ergebnis sehe. Die ganzen Befehle können aber selbstverständlich auch über den Aufgabenplaner eingegeben werden, dann erhaltet ihr je nach eurer Einstellung die Antwort per Mail. Das erschwert bei Problemen aber im Zweifelsfall die Ursachenfindung.		Dann möchte ich grundsätzlich anmerken, dass ich die ganzen Befehle in der Regel über mein Terminal absetze, weil ich dort sofort das Ergebnis sehe. Die ganzen Befehle können aber selbstverständlich auch über den Aufgabenplaner eingegeben werden, dann erhaltet ihr je nach eurer Einstellung die Antwort per Mail. Das erschwert bei Problemen aber im Zweifelsfall die Ursachenfindung.

	====~~= Anleitung =~~====		==== Anleitung ====
	Vor solchen Arbeiten solltet ihr sicherstellen, dass hier ein aktuelles und funktionierendes Back-up eurer Installation habt. Kein Backup → kein Mitleid		Vor solchen Arbeiten solltet ihr sicherstellen, dass hier ein aktuelles und funktionierendes Back-up eurer Installation habt. Kein Backup → kein Mitleid

Monacum: Updates und Links

2025-03-07T07:04:44Z

Updates und Links

← Nächstältere Version		Version vom 7. März 2025, 07:04 Uhr
Zeile 114:		Zeile 114:

	Wenn alles geklappt hat, findet Ihr nach der Anleitung oben Paperless unter <code><nowiki>http://domain:34343</nowiki></code>. Den Port 34343 könnt Ihr logischerweise anpassen.		Wenn alles geklappt hat, findet Ihr nach der Anleitung oben Paperless unter <code><nowiki>http://domain:34343</nowiki></code>. Den Port 34343 könnt Ihr logischerweise anpassen.

			==== Das „leidige“ Thema PostgreSQL-Updates… ====

			===== Grundsätzliches =====
			Immer wieder wird die Frage gestellt, wie im Zusammenhang mit Paperless-ngx eine Datenbankversion aktualisiert werden kann nach einem Major Update, wenn als Datenbank PostgreSQL zum Einsatz kommt. Da der ganze Vorgang nicht trivial ist und ich bei meinem Update von Version 15 auf 16 die eine oder andere Hürde gefunden habe, für die ich mir diverse Tips hier zusammengesucht habe nunmehr ein Versuch, das ganze in einer ausführlichen Anleitung zusammenzufassen.

			Stand 2. Februar 2024 ist die aktuellste Major Version von PostgreSQL v16, unterstützt und weiter mit Updates versorgt werden noch v12–v15. v11 hat im November 2023 das letzte Update erhalten. Folgende Versionen von PostgreSQL sind innerhalb ihrer Major Version derzeit aktuell:

			* 9. November 2023: <code>16.1</code>, <code>15.5</code>, <code>14.10</code>, <code>13.13</code>, <code>12.17</code> und <code>11.22</code> ( EOL)

			Anbei ein Bild, wo ihr, egal welcher Tag gesetzt wurde, seht, welche Version Eure Datenbank gerade verwendet.

			Auch wenn Updates immer eine sinnvolle Sache sind, so sei an dieser Stelle zunächst auch erwähnt, dass ein Update der Datenbank-Version keinerlei Vorteile im Betrieb von Paperless-ngx mit sich bringt. Neue Funktionen gibt es mit dem Update des Webservers, solange eine alte Version nicht zu Problemen führt, kann diese auch weiterverwendet werden.

			Wer erst mit Paperless-ngx startet, dem sei auch empfohlen, von Beginn an auf MariaDB als Datenbank zu setzen; wer bisher PostgreSQL einsetzt und gerne auf MariaDB wechseln möchte, dem sei diese Anleitung von @Adama ans Herz gelegt: Paperless-ngx: Migration Postgresql zu MariaDB. Bei großen Versionsupdates der MariaDB sind hier im Forum bisher keine Probleme bekannt und das im Vergleich umständliche Prozedere unten entfällt.

			===== Grundlagen =====
			Bevor ich beginne, möchte ich ein paar Begriffe klären, damit es nachher nicht zu Missverständnissen kommt bzw. ihr wisst, was ihr wo mit eventuell anderen Bezeichnungen ersetzen müsst.

			* Verwende ich <code>PGDBNAME</code>, so ist der Name eures PostgreSQL-Containers gemeint. Verwendet ihr paperless-ngx-db, nutzt ihr also diesen Namen.
			* Verwende ich <code>PGUSER</code>, ist der Name gemeint, der in Eurer Installation für die Anmeldung an der PostgreSQL-Datenbank verwendet wird. Standardmäßig ist das in der yaml-Beispielsdatei <code>paperless</code>

			Dann möchte ich grundsätzlich anmerken, dass ich die ganzen Befehle in der Regel über mein Terminal absetze, weil ich dort sofort das Ergebnis sehe. Die ganzen Befehle können aber selbstverständlich auch über den Aufgabenplaner eingegeben werden, dann erhaltet ihr je nach eurer Einstellung die Antwort per Mail. Das erschwert bei Problemen aber im Zweifelsfall die Ursachenfindung.

			===== Anleitung =====
			Vor solchen Arbeiten solltet ihr sicherstellen, dass hier ein aktuelles und funktionierendes Back-up eurer Installation habt. Kein Backup → kein Mitleid

			# Stoppt die Container des Webservers und des Brokers (redis), um zu verhindern, dass weitere Daten in die Datenbank geschrieben werden können (der PostgreSQL-Container muss weiterlaufen, weil sonst kein „Dump“ erstellt werden kann)
			# Erstellt einen so genannten „Dump“, also eine Sicherung der Datenbank mit folgendem Befehl: <code>docker exec PGDBNAME bash -c "psql -U PGUSER > /var/lib/postgresql/data/backup/backup.dump"</code>
			# Stoppt den PostgreSQL-Container und benennt den bisherigen Ordner (z. B. <code>/pgdata</code>) um, der Einfachheit halber etwa <code>pgdatav15</code> für die alte Version und erstellt /pgdata neu. Der Ordner muss (!) leer sein!
			# Passt in der Konfiguration (yaml) die Version von PostgreSQL an (z. B. auf <code>postgres:16</code>) (*1)
			# Startet zunächst nur die Datenbank neu, in dem ihr in den Ordner navigiert <code>cd /volume1/docker/paperless/oder/so</code> und dann folgenden Befehl ausführt <code>docker-compose up -d db</code>
			# Kopiert den Backup-Ordner mit dem Dump in <code>/pgdata</code>
			# Führt folgenden Befehl aus <code>docker exec PGDBNAME bash -c "psql -U PGUSER < /var/lib/postgresql/data/backup/backup.dump"</code>, danach seht ihr im Terminal, wie die Daten eingelesen werden
			# Wenn der Befehl ohne Fehler durchgelaufen ist, startet Webserver und Broker erneut: <code>docker-compose up -d</code>

			Danach solltet ihr euch mit den bekannten Anmeldedaten wieder anmelden können. Wird die Anmeldeseite geladen, funktioniert das Anmelden aber nicht mit Verweis auf falsche Anmeldedaten, dann hat das zurückspielen der Datenbank nicht funktioniert.

			=== Zusätzliche Links ===
			Folgende zusätzliche Links können euch helfen, wenn ihr doch mal an Probleme kommt, die ihr so nicht klären könnt:

			* MariusHosting (Marius Bogdan Lixandru): [https://mariushosting.com/how-to-install-paperless-ngx-on-your-synology-nas/ How to Install Paperless NGX on Your Synology NAS]
			* [https://www.youtube.com/@DigitalisierungmitKopf/videos Digitalisierung mit Kopf] (Stefan Lachner)
			** Paperless-ngx: Automatische Texterkennung (OCR) in Scans mit Synology NAS / Raspberry Pi
			** Paperless-ngx auf Synology-NAS installieren: Schritt-für-Schritt-Anleitung (papierloses Büro)
			** HTTPS: Paperless-ngx aus dem Internet erreichbar machen mit Synology NAS

Monacum: /* Paperless-ngx – Ein Sammelthread für ein DMS via Docker auf dem NAS */ Anleitung ergänzt aus dem Forum

2025-03-07T06:59:24Z

Paperless-ngx – Ein Sammelthread für ein DMS via Docker auf dem NAS: Anleitung ergänzt aus dem Forum

@@ Zeile 15: / Zeile 15: @@
 * Fix: also ensure symmetric doc link removal on bulk edit by @shamoon in #8963<br />
 </div>
-=== Wozu dient dieser Thread? ===
+=== Was ist Paperless-ngx? ===
-Dieser Thread ist als Sammelthread gedacht für Fragen zu Paperless-ngx und zur Information für alle, die Paperless nutzen. Paperless-ngx ist ein Fork von Paperless-ng, einem Dokumentenmanagementsystem (DMS), welches als Container unter Docker/Container Manager (ab DSM 7.2) läuft. Zusätzlich zu allgemeinen Fragen werde ich hier entsprechend einen Beitrag erstellen, wenn eine neue Version erscheint. „Größere Probleme“ sprecht besser nicht hier an, sondern eröffnet einen eigenen Thread unter Blog → Foren → Verschiedenes → 3rd Party-Anwendungen und setzt dann den Paperless-Tag.
+Paperless-ngx ist ein Fork von Paperless-ng, einem Dokumentenmanagementsystem (DMS), welches als Container unter Docker/Container Manager (ab DSM 7.2) läuft. Zusammen mit einem Scanner könnt ihr euer Büro zu Hause papierlos machen und findet über Schlagwörter schnell die Dokumente, die ihr sucht. Eigentlich können gescannte Dokumente auch nummeriert werden, sodass ihr sie auch im Original schnell wiederfindet, wenn ihr sie doch mal brauchen solltet.
 === Ist Paperless-ngx überhaupt etwas für mich? ===
@@ Zeile 24: / Zeile 24: @@
 === Wie installiere ich Paperless-ngx? ===
-Dazu findest du eine ausführliche Anleitung [https://www.synology-forum.de/threads/paperless-ngx-dms-via-docker-auf-dem-nas.124614/page-12#post-1068063 '''ab hier'''] in zwei Beiträgen. Gerne Feedback geben, wenn es Probleme damit gibt. Ein anderer User, der ebenfalls Paperless-ngx im Einsatz hat und immer mit Rat und Tat zur Seite steht, ist derzeit hier @Adama, viele weitere hilfreiche Beiträge stammen aus der Feder von @EDvonSchleck.
+Wie so oft bei Docker gibt es hier unterschiedliche Herangehensweisen. Man kann für die Verwaltung aller seiner Container andere Containerdienste wie Portainer verwenden oder auch den Container-Manager vom Synology selbst; allerdings verwende ich selbst ausschließlich die Konfigurationsdateien im YML-Format. Deswegen beachtet bitte, dass beispielsweise Anleitungen von Magnus auf seiner Seite Magnus Hosting ein wenig anders aussehen als das, was ihr hier seht.

Monacum: Versionsbox

2025-02-26T08:47:39Z

Versionsbox

@@ Zeile 1: / Zeile 1: @@
 == Paperless-ngx – Ein Sammelthread für ein DMS via Docker auf dem NAS==
 === Wozu dient dieser Thread? ===
 Dieser Thread ist als Sammelthread gedacht für Fragen zu Paperless-ngx und zur Information für alle, die Paperless nutzen. Paperless-ngx ist ein Fork von Paperless-ng, einem Dokumentenmanagementsystem (DMS), welches als Container unter Docker/Container Manager (ab DSM 7.2) läuft. Zusätzlich zu allgemeinen Fragen werde ich hier entsprechend einen Beitrag erstellen, wenn eine neue Version erscheint. „Größere Probleme“ sprecht besser nicht hier an, sondern eröffnet einen eigenen Thread unter Blog → Foren → Verschiedenes → 3rd Party-Anwendungen und setzt dann den Paperless-Tag.

Monacum: Erste Version, aus dem Thread übernommen

2025-02-26T08:37:33Z

Erste Version, aus dem Thread übernommen

Neue Seite

== Paperless-ngx – Ein Sammelthread für ein DMS via Docker auf dem NAS==
=== Wozu dient dieser Thread? ===
Dieser Thread ist als Sammelthread gedacht für Fragen zu Paperless-ngx und zur Information für alle, die Paperless nutzen. Paperless-ngx ist ein Fork von Paperless-ng, einem Dokumentenmanagementsystem (DMS), welches als Container unter Docker/Container Manager (ab DSM 7.2) läuft. Zusätzlich zu allgemeinen Fragen werde ich hier entsprechend einen Beitrag erstellen, wenn eine neue Version erscheint. „Größere Probleme“ sprecht besser nicht hier an, sondern eröffnet einen eigenen Thread unter Blog → Foren → Verschiedenes → 3rd Party-Anwendungen und setzt dann den Paperless-Tag.

=== Ist Paperless-ngx überhaupt etwas für mich? ===
Das kann man natürlich immer nur für sich selbst beantworten. Manche Personen greifen lieber direkt auf ihre Dokumente in den Ordnern zu, für diejenigen ist vielleicht synOCR besser geeignet. Wer Paperless-ngx nutzen möchte, sollte die gesamte Verwaltung von dem Programm machen lassen und Änderungen nur über die Oberfläche vornehmen. Die Dateien lassen sich trotzdem ohne große Probleme aus der Ordnerstruktur heraus kopieren oder über die Oberfläche herunterladen.

Wer noch weitere Gedanken zur Entscheidung braucht, dem sei der Thread [https://www.synology-forum.de/threads/paperless-ngx-ein-kurzer-erfahrungsbericht-sowie-ein-erstes-resuemee.133974/ Paperless-ngx: Ein kurzer Erfahrungsbericht sowie ein erstes Resümee] von [[Benutzer:Tommes|Tommes]] empfohlen. Dort wird über viele Fragen diskutiert, die immer mal wieder hier im Forum aufkommen, weil Paperless-ngx schon eine feine Sache, aber nicht für jede Arbeitsweise geeignet ist. Solche Fragen sollte man jedenfalls klären, bevor man die ersten 1000 Dokumente verarbeitet 😉

=== Wie installiere ich Paperless-ngx? ===
Dazu findest du eine ausführliche Anleitung [https://www.synology-forum.de/threads/paperless-ngx-dms-via-docker-auf-dem-nas.124614/page-12#post-1068063 '''ab hier'''] in zwei Beiträgen. Gerne Feedback geben, wenn es Probleme damit gibt. Ein anderer User, der ebenfalls Paperless-ngx im Einsatz hat und immer mit Rat und Tat zur Seite steht, ist derzeit hier @Adama, viele weitere hilfreiche Beiträge stammen aus der Feder von @EDvonSchleck.