Paperless-NGX Installationsanleitung in der Container Station

Hallo,

wie im Beitrag beschrieben, habe ich in der crontab den Eintrag zum automatischen Export hinzugefügt.

Der Export als .zip funktioniert auch - entsprechende Dateien werden in der Outbox abgelegt.

Allerdings werden alle bereits abgelegten Dateien behalten und keine automatisch gelöscht.

Manuell löschen kann ich die "alten" Dateien problemlos...

Wo könnte der Fehler liegen?

Zitat von vore76

1. Die Datei "export.sh" aus der Zip-Datei (Anhang zu diesem Post) in den Container-Ordner kopieren (am einfachsten via Drag&Drop in der FileStation) in den Pfad:
   /share/CACHEDEV1_DATA/Container/container-station-data/application/paperless-ngx
   Copy_Export.png
2. Über SSH am NAS einloggen und die Abfrage mit "Q" und die zweite Abfrage mit "Y" beantworten.
3. In den Pfad /etc/config/ wechseln.
4. Die Datei "crontab" mit VI öffnen: vi crontab (Kurzanleitung zu VI hier: http://org.netbase.org/vi.html)
5. Zum Ende der Datei springen und einen Eintrag ergänzen (mit i) und am Ende mit :wq speichern und wieder verlassen.
   30 1 * * 1,3,6 sh /share/CACHEDEV1_DATA/Container/container-station-data/application/paperless-ngx/export.sh > /dev/null 2>&1
   Der Befehl triggert das Script für den Export jeweils Montags, Mittwochs und Samstags um 01:30

Naja, der export.sh macht ja nichts anderes als eine ZIP Datei in einen Ordner zu werfen.
Ich selber behalte nur immer eine Datei, da diese später mit rclone in die Cloud gesendet wird.
Ohne Garantie, dass dies auch auf einem NAS geht (Bei mir läufts auf Debian 13).
Pfade müssen angepasst werden.... Export_DIR, APP_DIR, document exporter

#!/bin/bash

# Pfade definieren
EXPORT_DIR="ANPASSEN"
APP_DIR="ANPASSEN"

# Zeitstempel generieren (Ohne .zip am Ende)
TIMESTAMP=$(date +"%Y-%m-%d_%H-%M")
FILENAME="export_$TIMESTAMP"

# In das Verzeichnis wechseln und aufräumen
cd "$EXPORT_DIR" || exit
rm -f *.zip

# In das App-Verzeichnis wechseln und Export starten
cd "$APP_DIR" || exit
docker compose exec -T webserver document_exporter ../export -z -zn "$FILENAME"

Noch etwas schöner, dass 7 Versionen behalten werden, mehr oder weniger bei Bedarf.

#!/bin/bash

EXPORT_DIR="ANPASSEN"
APP_DIR="ANPASSEN"
KEEP_VERSIONS=7

TIMESTAMP=$(date +"%Y-%m-%d_%H-%M")
FILENAME="export_$TIMESTAMP"

cd "$APP_DIR" || exit 1
docker compose exec -T webserver document_exporter ../export -z -zn "$FILENAME"

if [ $? -eq 0 ]; then
    cd "$EXPORT_DIR" || exit 1
    ls -1t export_*.zip 2>/dev/null | tail -n +$((KEEP_VERSIONS + 1)) | xargs -r rm
fi

ls -lh "$EXPORT_DIR"

Hallo NightStalk3r

Danke schon mal, hab es jetzt dank chat GPT auf QNAP "getrimmt" und werde testen...

Hallo zusammen,

Ich habe eine Frage in die Runde. Hat jemand eine zweite Paperless-ngx Instanz auf dem gleichen NAS angelegt?

Ich würde mir gerne eine Test-Instanz anlegen, aber natürlich vermeiden, dass ich Probleme mit meiner Hauptinstanz bekomme.

Auf YouTube bin ich auf dieses Video gestoßen (Link). Hier wird erklärt was zu beachten ist, wenn man eine zweite Instanz anlegen möchte. Ich bin mir aber nicht sicher, ob das so auch auf die Konfiguration bei QNAP zutrifft.

Ich gehe davon aus, dass ich einen neuen Port in der .yml festlegen muss. Aktuell verwende ich den Port 8000, dann könnte ich ja jetzt den 8100 nehmen.

Dann muss ich vermutlich auch ein neues Verzeichnis in der File Station anlegen, also z.B. „Paperless-ngx-Test“. In diesem muss ich dann die Ordner wieder anlegen und das alles natürlich in der .yml anpassen.

Ist das alles was ich machen muss? In dem Video wird noch etwas anderes beschrieben mit .env Dateien. Allerdings handelt es sich bei ihm auch um ein Synology NAS.

Hat das schon mal jemand gemacht und kann mir weiterhelfen?

Danke schon mal.

Zitat von NightStalk3r

Noch etwas schöner, dass 7 Versionen behalten werden, mehr oder weniger bei Bedarf.

Hallo NightStalk3r
das mit den 7 Versionen klapp so wunderbar...
hier der für QNAP angepasst Code:

#!/bin/bash

APP_DIR="/share/CACHEDEV1_DATA/Paperless-Docs"
EXPORT_DIR="/share/CACHEDEV1_DATA/Paperless-Docs/Outbox"
KEEP_VERSIONS=7

TIMESTAMP=$(date +"%Y-%m-%d_%H-%M")
FILENAME="export_$TIMESTAMP"

cd "$APP_DIR" || exit 1

docker exec paperless \
document_exporter /usr/src/paperless/export \
-z -zn "$FILENAME"

if [ $? -eq 0 ]; then
cd "$EXPORT_DIR" || exit 1
ls -1t export_*.zip 2>/dev/null | tail -n +$((KEEP_VERSIONS + 1)) | xargs -r rm
fi

ls -lh "$EXPORT_DIR"

Danke nochmal!

Hi!

Welche Berechtigungen braucht denn das DB-Verzeichnis?

Das Problem ist das: ich habe heute in QNAP auf die neuen ACL umgestellt. Seitdem geht der Containerdienst nicht mehr richtig.

Wenn ich Paperless starte, steht in den Datenbanklogs das:

PostgreSQL Database directory appears to contain a database; Skipping initialization
2026-03-26 16:02:32.796 UTC [1] FATAL:  could not open lock file "postmaster.pid": Permission denied

Ich habe dann mal die Fileberechtigungen angeschaut. Die stehen nach jedem Start auf einem nicht existenten Account:

pasted-from-clipboard.png

Auch wenn ich den ändere, steht er nach dem nächsten Containerstart wieder so.

Hat jemand eine Idee, was das Problem sein könnte?

EDIT: nur die Datenbank startet nicht, alles andere geht.

Ein Hinweis an alle, die das Update auf Paperless NGX 3.0 gefahren haben und nun feststellen, dass der Webserver nicht mehr startet: Es gab Breaking Changes.

Ich erlaube mir hier mal den Migrationsguide zu verlinken: https://docs.paperless-ngx.com/migration-v3/

Insbesondere wird die Environment-Variable "PAPERLESS_SECRET_KEY" ab Version 3.0 zwingend benötigt, sonst startet der Server nicht.

Außerdem sollen wohl noch Umstellungen wegen der Datenbank notwendig sein (lustigerweise ist es bei mir auch ohne gestartet:

# v2 (PostgreSQL inferred from PAPERLESS_DBHOST)
PAPERLESS_DBHOST: postgres

# v3 (engine must be explicit)
PAPERLESS_DBENGINE: postgresql
PAPERLESS_DBHOST: postgres

Wie man den PAPERLESS_SECRET_KEY aus der alten Version übernimmt wird aber nirgendwo erwähnt.
Das Ganze ist wohl alles nicht so einfach. Ich bleib erst mal bei der 2er Version. Ich brauche keine KI.

Zumindest ich hatte in der Vorversion überhaupt keinen Secret Key. Ich habe einfach die Environment Variable in meinem Compose hinzugefügt und über einen Online Generator einen neuen Key erzeugt.

Zitat von Herr_der_Klingen

Code

# v3 (engine must be explicit)
PAPERLESS_DBENGINE: postgresql
PAPERLESS_DBHOST: postgres

In der .yml aus #317 verweist im Service "Webserver" die env "paperless dbhost: db" auf den Service "db:"

Muss da noch etwas, die Sektion db in Services umbenannt werden?

----

Wo wird der Befehl zur Erzeugung des Secret-Key eingegeben?

gruß, zero K

Bei mir muss PAPERLESS_DBHOST: db lauten bzw auf den Service weisen.

Wenn ich PAPERLESSS_DBHOST: postgres eintrage startet die Datenbank nicht.

Der in der Paperless-Doku genannte Befehl zur Erzeugung des Secret-Key funktioniert bei mir ssh admin@nasip.port nicht.

An einer separaten Workstation, mit einer neueren, der neueren Python-Version 3.13.14 habe ich die Zeichenkette erhalten.

Diese habe ich dann im yaml eingetragen.

Ist vielleicht einfacher, wenn ich mein aktuelles auf V3 angepasstes Compose einstelle und die ergänzten Stellen befinden sich in Zeile 57 und 81:

version: '3.6'

networks:
  paperless-net:
    external: false

services:
  broker:
    container_name: paperless-redis
    image: redis:7
    networks:
      - paperless-net
    volumes:
      - /share/Container/Paperless-NGX/redis:/redis
    restart: unless-stopped

  db:
    container_name: paperless-db
    image: postgres:18
    networks:
      - paperless-net
    restart: unless-stopped
    volumes:
      - /share/Container/Paperless-NGX/postgres:/var/lib/postgresql
    environment:
      POSTGRES_DB: paperless
      POSTGRES_USER: paperless
      POSTGRES_PASSWORD: Hrh45ge5GHfe45

  webserver:
    container_name: paperless
    image: ghcr.io/paperless-ngx/paperless-ngx:latest
    networks:
      - paperless-net
    restart: unless-stopped
    depends_on:
      - db
      - broker
      - gotenberg
      - tika
    ports:
      - 8020:8000 #Webport von Paperless
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8000"]
      interval: 30s
      timeout: 10s
      retries: 5
    volumes:
      - /share/Container/Paperless-NGX/data:/usr/src/paperless/data
      - /share/Container/Paperless-NGX/media:/usr/src/paperless/media
      - /share/Container/Paperless-NGX/export:/usr/src/paperless/export #den Ordner "export" von Paperless auf den Ordner export mappen
      - /share/Container/Paperless-NGX/consume:/usr/src/paperless/consume #den Ordner "consume" von Paperless auf den Ordner consume mappen
    environment:
      PAPERLESS_REDIS: redis://broker:6379
      PAPERLESS_DBHOST: db
      PAPERLESS_DBPASS: Hrh45ge5GH
      PAPERLESS_DBENGINE: postgresql
      USERMAP_UID: 1000 
      USERMAP_GID: 100
      PAPERLESS_OCR_LANGUAGES: eng deu
      PAPERLESS_TIME_ZONE: Europe/Berlin
      PAPERLESS_OCR_LANGUAGE: deu
      PAPERLESS_OCR_USER_ARGS: '{"invalidate_digital_signatures": true}'
      PAPERLESS_FILENAME_FORMAT: "{{correspondent}}/{{created_year}}/{{created}} {{title}}"
      PAPERLESS_CONSUMER_RECURSIVE: 1
      PAPERLESS_CONSUMER_SUBDIRS_AS_TAGS: true
      PAPERLESS_FILENAME_DATE_ORDER: YMD
      PAPERLESS_IGNORE_DATES: 24.03.1990
      #PAPERLESS_ADMIN_USER: ADMIN
      #PAPERLESS_ADMIN_PASSWORD: Passwort123
      PAPERLESS_TIKA_ENABLED: 1
      PAPERLESS_TIKA_GOTENBERG_ENDPOINT: http://gotenberg:3000
      PAPERLESS_TIKA_ENDPOINT: http://tika:9998
      PAPERLESS_EMAIL_HOST: smtp.web.de
      PAPERLESS_EMAIL_PORT: 587
      PAPERLESS_EMAIL_HOST_USER: admin@web.de
      PAPERLESS_EMAIL_HOST_PASSWORD: Passwort123
      PAPERLESS_EMAIL_FROM: admin@web.de
      PAPERLESS_EMAIL_USE_TLS: true
      PAPERLESS_EMAIL_USE_SSL: false
      PAPERLESS_SECRET_KEY: VERDAMMTLANGEZUFÄLLIGZEICHENFOLGE
  
  db-backup:
    container_name: paperless-db-backup 
    image: postgres:18
    volumes:
      - /share/Container/Paperless-NGX/db-backup:/dump 
      - /etc/localtime:/etc/localtime:ro 
    restart: unless-stopped
    environment: 
      PGHOST: db 
      PGDATABASE: paperless 
      PGUSER: paperless 
      PGPASSWORD: Hrh45ge5GHfe45
      BACKUP_NUM_KEEP: 10 
      BACKUP_FREQUENCY: 7d # Alle 7 Tage Backup auf die Backup-DB kopieren, kann man anpassen
    entrypoint: | 
      bash -c 'bash -s <<EOF 
      trap "break;exit" SIGHUP SIGINT SIGTERM 
      sleep 2m 
      while /bin/true; do
        pg_dump -Fc > /dump/dump_\`date +%d-%m-%Y"_"%H_%M_%S\`.psql 
        (ls -t /dump/dump*.psql|head -n $$BACKUP_NUM_KEEP;ls /dump/dump*.psql)|sort|uniq -u|xargs rm -- {} 
        sleep $$BACKUP_FREQUENCY 
      done 
      EOF' 
    networks:
      - paperless-net

  gotenberg:
    container_name: paperless-gotenberg
    image: gotenberg/gotenberg:latest
    restart: unless-stopped
    environment:
      CHROMIUM_DISABLE_ROUTES: 1
    networks:
      - paperless-net

  tika:
    container_name: paperless-tika
    image: apache/tika:latest
    restart: unless-stopped
    networks:
      - paperless-net

Gegebenenfalls müssen noch bestimmte OCR Variablen raus, die habe ich aber nie gesetzt.

Die Variable PAPERLESS_DBHOST bleibt unverändert (bei uns beiden auf "db"). Auf der Dokumentationsseite für die V3 Migration lautet der Wert für den DBHost wahrscheinlich nur deswegen "postgres", weil der Datenbankcontainer in deren Mustercompose wahrscheinlich nicht "db" sondern "postgres" heißt. Entsprechend musst du an der Stelle nichts ändern.

Es kommt nur noch eine weitere Variable PAPERLESS_DBENGINE mit dem Wert "postgresql" hinzu.

Einen Befehl zur Erzeugung eines Secret Keys in dem Sinne habe ich nicht genutzt. Ich habe lediglich die Variable eingefügt und sie mit einer hinreichend langen Zufallszeichenfolge ausgestattet (entweder du knallst deinen Kopf ein paar Mal auf die Tastatur um Zufallseingaben zu erzeugen oder du entscheidest dich für die weniger kopfschmerzenträchtige Variante und verwendest zum Beispiel so was: https://randomkeygen.com/secret-key  ).

Wg. meines recht hohen Haaransatzes bevorzugte ich die Konsole.

Ich nutzte den Befehl aus der Migrations-Hilfe hinter Deinem Link weiter oben.

python3 -c "import secrets; print(secrets.token_urlsafe(64))"

May be, dass im neuen QTS hero 6 die Python3 Version nicht passt.

Im Python3 eines maximal eine Woche alten openSuse Tumbleweed hat der Befehl sofort funktioniert.

Danke

Gruß zero K

Herr_der_Klingen:

Hat sich auch der Port des Webservers verändert?

  webserver:
....
    ports:
      - 8020:8000 #Webport von Paperless

in meiner (ok, recht alten) .yml ist es noch 8000:8000

EDIT: Ich vermute mal das du diese Einstellung getätigt hast weil du Port 8000 schon anderweitig verwendest...

Ich habe ihn auf 8020 gemappt, weil 8000 schon in Verwendung war. 8000:8000 würde aber grundsätzlich auch weiterhin funktionieren.

Herr_der_Klingen:

Was mir noch aufgefallen ist an deiner .yaml ist das du die Postgress Version 18 geändert hast

image: postgres:18

Muss man das manuell vorm Update machen?

Das Postgres Update ist optional und hat nichts mit V3 zu tun. Ich hatte über meine diversen Container zwischen Postgres 14 und 18 gefühlt jede Hauptversion irgendwo laufen. Das habe ich jetzt soweit wie möglich alles auf halbwegs aktuelle Versionen angehoben (zumal die sehr alten Postgres teilweise schon aus dem Support fallen). Wenn du das auch machen willst, geht das am einfachsten über die Document_Exporter Funktion (alles sichern, Datenbank löschen und dann in die neue Datenbank die Sicherung zurückspielen).