Paperless-ngx auf UGREEN DXP 4800 Plus mit UGOS Pro installieren (Docker Compose)

Januar 27, 2026 Daniel Greiser

In diesem Beitrag zeige ich dir Schritt für Schritt, wie du paperless-ngx auf einer UGREEN NASync DXP 4800 Plus unter UGOS Pro installierst – sauber, reproduzierbar und mit einer ordentlichen Ordnerstruktur.
Wir nutzen Docker Compose, damit die Installation nicht nur einmal klappt, sondern auch später Updates/Backups einfach bleiben.

Hinweis: Du brauchst nicht zwingend die Docker-App in UGOS Pro – du kannst alles per SSH/Terminal machen. Die App ist nur komfortabel zum Starten/Stoppen/Logs ansehen.

Hier klicken, um den Inhalt von YouTube anzuzeigen.
Erfahre mehr in der Datenschutzerklärung von YouTube.

Inhalt von YouTube immer anzeigen

Was ist Paperless-ngx – und was läuft im Hintergrund?

Paperless-ngx besteht in diesem Setup aus drei Containern:

paperless: die Weboberfläche + Verarbeitung (Import, OCR, Suche, Tags, Regeln)
db (PostgreSQL): Datenbank für Benutzer, Tags, Regeln, Metadaten usw.
redis: Job-Queue/Broker für Hintergrundaufgaben (Import/OCR), damit die Weboberfläche flüssig bleibt

Voraussetzungen

UGREEN NAS mit UGOS Pro
Docker + Docker Compose installiert (bei dir: Compose v2.x)
SSH aktiviert (Systemsteuerung → Terminal → SSH aktivieren)

Ordnerstruktur auf dem NAS

Lege dir einen Ordner für Paperless an (bei mir liegt das auf /volume2, bei dir kann es auch /volume1 sein).

Beispiel:

/volume2/docker/paperless/
├─  consume/
├─  data/
├─  media/
├─  export/
└─  db/

Wofür ist welcher Ordner?

consume/ → Eingangskorb / Hotfolder: Hier landen neue Scans/PDFs, die Paperless automatisch importiert.
media/ → Dokumentenarchiv: Hier liegen am Ende deine finalen Dokumente (sehr wichtig fürs Backup).
data/ → App-Daten: Paperless interne Daten/Index/Thumbnails etc.
export/ → Exporte/Backups: Ziel für Exporte aus Paperless heraus.
db/ → Datenbank: PostgreSQL-Daten (User, Tags, Regeln, Metadaten, Zuordnungen).

Tipp: Viele Fehler entstehen durch einen Tippfehler. Der Ordner heißt consume (nicht „consumer“).

Docker Compose Datei anlegen (`docker-compose.yml`)

Erstelle im Ordner /volume2/docker/paperless/ eine Datei namens:

docker-compose.yml

und füge folgendes ein:

services:
    db:
        image:  postgres:16
        container_name:  paperless-db
        restart:  unless-stopped
        environment:
            POSTGRES_DB:  paperless
            POSTGRES_USER:  paperless
            POSTGRES_PASSWORD:  CHANGE_ME_DB_PASSWORD
        volumes:
            -  /volume2/docker/paperless/db:/var/lib/postgresql/data

    redis:
        image:  redis:7
        container_name:  paperless-redis
        restart:  unless-stopped

    paperless:
        image:  ghcr.io/paperless-ngx/paperless-ngx:latest
        container_name:  paperless
        restart:  unless-stopped
        depends_on:
            -  db
            -  redis
        ports:
            -  "8000:8000"
        environment:
            PAPERLESS_REDIS:  redis://redis:6379

            PAPERLESS_DBHOST:  db
            PAPERLESS_DBNAME:  paperless
            PAPERLESS_DBUSER:  paperless
            PAPERLESS_DBPASS:  CHANGE_ME_DB_PASSWORD

            PAPERLESS_TIME_ZONE:  Europe/Berlin
            PAPERLESS_OCR_LANGUAGE:  deu+eng

            PAPERLESS_SECRET_KEY:  CHANGE_ME_SUPER_SECRET_KEY
            #  Optional  bei  Reverse  Proxy  /  eigener  Domain:
            #  PAPERLESS_URL:  https://paperless.deinedomain.tld

            #  Optional  bei  Rechteproblemen:
            #  PAPERLESS_UID:  1000
            #  PAPERLESS_GID:  1000

        volumes:
            -  /volume2/docker/paperless/data:/usr/src/paperless/data
            -  /volume2/docker/paperless/media:/usr/src/paperless/media
            -  /volume2/docker/paperless/export:/usr/src/paperless/export
            -  /volume2/docker/paperless/consume:/usr/src/paperless/consume

Was MUSS angepasst werden?

Pfade: Wenn du nicht /volume2 nutzt, ersetze überall /volume2 durch dein Volume (z. B. /volume1).
DB Passwort: CHANGE_ME_DB_PASSWORD ersetzen (starkes Passwort).
- Wichtig: POSTGRES_PASSWORD und PAPERLESS_DBPASS müssen identisch sein.
Secret Key: CHANGE_ME_SUPER_SECRET_KEY ersetzen (lang & zufällig).
- Das ist der Signierschlüssel (Sessions/CSRF/Token-Signaturen). Einmal setzen und danach nicht mehr ändern.

Secret Key generieren (Mac):

openssl  rand  -base64  48

Installation per SSH (Start des Stacks)

Per SSH auf die NAS verbinden:

ssh  <DEIN_USER>@<NAS-IP>

Dann in den Ordner wechseln und prüfen, ob die Compose-Datei da ist:

cd  /volume2/docker/paperless
ls  -la

Wenn du hier docker-compose.yml siehst, Stack starten:

sudo  docker  compose  up  -d

Status prüfen:

sudo  docker  compose  ps

Erster Login / Benutzer anlegen (2 Wege)

Weg 1: Im Browser (First-Run Maske)

Öffne:

http://NAS-IP:8000

Wenn Paperless beim ersten Aufruf eine „User anlegen“-Maske zeigt: Admin erstellen → fertig.

Weg 2: Plan B (immer zuverlässig per Terminal)

Falls die Maske nicht erscheint oder du keinen Login hast:

sudo  docker  compose  exec  paperless  python  manage.py  createsuperuser

Danach im Browser anmelden unter http://NAS-IP:8000.

Test: Automatischer Import über den consume-Ordner

Lege eine PDF in:

/volume2/docker/paperless/consume

Paperless sollte die Datei automatisch importieren und verarbeiten (OCR), danach taucht sie im Web-UI auf.

Typische Fehler & schnelle Lösungen

1) „no configuration file provided: not found“

Du bist im falschen Ordner.

Fix:

pwd
ls  -la

Du musst die docker-compose.yml im aktuellen Verzeichnis sehen.
Alternativ direkt mit Pfad starten:

sudo  docker  compose  -f  /volume2/docker/paperless/docker-compose.yml  up  -d

2) Container startet ständig neu (Restart-Loop)

Fast immer ein Log-Problem: DB, Passwort, Rechte, Migration.

Logs anschauen:

sudo  docker  compose  logs  --tail=200  paperless
sudo  docker  compose  logs  --tail=200  db

Sehr häufig: DB-Passwort falsch / geändert

Wenn in den Logs steht:
password authentication failed for user "paperless"

Dann stimmen POSTGRES_PASSWORD und PAPERLESS_DBPASS nicht überein – oder du hast das Passwort nach dem ersten Start geändert.

Wenn noch keine Daten wichtig sind (sauberer Reset):

sudo  docker  compose  down
sudo  rm  -rf  /volume2/docker/paperless/db/*
sudo  docker  compose  up  -d

Achtung: Das löscht die Datenbank (Paperless-Metadaten). Dokumente in media bleiben, aber Zuordnungen/Tags wären weg.

3) Rechteprobleme (Permission denied)

Wenn Paperless nicht in data/media/consume schreiben kann, hilft meist:

NAS-Rechte prüfen oder
PAPERLESS_UID / PAPERLESS_GID setzen

Updates (kurz & schmerzfrei)

cd  /volume2/docker/paperless
sudo  docker  compose  pull
sudo  docker  compose  up  -d

Backup Empfehlung (Minimal)

Mindestens sichern:

/volume2/docker/paperless/db
/volume2/docker/paperless/media
/volume2/docker/paperless/data

Optional zusätzlich:

/volume2/docker/paperless/export

Fazit

Wenn Ordnerstruktur, Compose-Datei und Passwörter sauber gesetzt sind, läuft Paperless-ngx auf der UGREEN NAS sehr stabil.
Der Vorteil des Docker-Compose-Setups: einfach startbar, leicht updatebar und gut zu sichern.

Wenn du Fragen hast oder irgendwo hängst: Schreib gern in die Kommentare (am besten mit der Ausgabe von docker compose ps und den Logs).

Downloads

✅ Docker Compose Vorlage (docker-compose.yml):
👉 Download: Docker Compose Beispiel Datei