Written by 09:49 Docker, NAS, Synology, Ugreen • 38 Comments Views: 3.054

Paperless-ngx auf einem Synology NAS installieren

In diesem Blogbeitrag zeige ich dir, wie du Paperless-ngx, eine moderne Dokumentenverwaltungssoftware, auf deinem Synology NAS installierst. Paperless-ngx hilft dir, deine Dokumente zu digitalisieren, zu organisieren und einfach wiederzufinden. Wir nutzen dafür Docker und den Synology Container Manager.

In diesem Blogbeitrag zeige ich dir, wie du Paperless-ngx, eine moderne Dokumentenverwaltungssoftware, auf deinem Synology NAS installierst. Paperless-ngx hilft dir, deine Dokumente zu digitalisieren, zu organisieren und einfach wiederzufinden. Wir nutzen dafür Docker und den Synology Container Manager.


Voraussetzungen

  • Ein Synology NAS mit DSM 7.x oder neuer.
  • Docker (über den Synology Package Manager installiert).
  • Grundlegende Kenntnisse im Umgang mit der Synology-Oberfläche.

Falls Du ein Ugreen NAS verwendest kannst Du diesem Tutorial 1:1 folgen. Du kannst außerdem die docker-compose Datei unverändert für Dein Ugreen NAS nutzen!


Schritt 1: Ordnerstruktur anlegen

Zuerst legen wir die benötigten Ordner für Paperless-ngx an. Diese Ordner werden verwendet, um die Daten persistent zu speichern.

  1. Öffne den File Station auf deinem Synology NAS.
  2. Navigiere zu /volume1/docker/.
  3. Erstelle einen neuen Ordner namens paperless.
  4. Innerhalb des paperless-Ordners erstellst du folgende Unterordner:
    • redis (für Redis-Daten)
    • db (für die PostgreSQL-Datenbank)
    • data (für Paperless-Dokumente)
    • media (für Paperless-Medien)
    • export (für Exporte)
    • consume (für neue Dokumente, die importiert werden sollen)

Die Ordnerstruktur sollte so aussehen:

/volume1/docker/paperless/
├── redis
├── db
├── data
├── media
├── export
└── consume

Schritt 2: Projekt im Container Manager erstellen

Jetzt richten wir Paperless-ngx im Synology Container Manager ein.

  1. Öffne den Container Manager auf deinem Synology NAS.
  2. Klicke auf Projekt und dann auf Erstellen.
  3. Gib dem Projekt den Namen paperless-ngx.

Schritt 3: Docker Compose Datei erstellen

Nun erstellen wir die docker-compose.yml-Datei, die die Konfiguration für Paperless-ngx enthält.

  1. Wähle im Dropdown-Menü die Option Neue Docker-Compose-Datei erstellen.
  2. Kopiere den folgenden Inhalt in die Datei:
services:

  broker:
    image: docker.io/library/redis
    container_name: paperless-redis
    restart: always
    user: "1026:100" # UID und GID hinzugefügt mit eigener Eigener ersetzen
    volumes:
      - /volume1/docker/paperless/redis:/data
    networks:
      - paperless-network

  db:
    image: docker.io/library/postgres:17
    container_name: paperless-db
    restart: always
    environment:
      POSTGRES_DB: paperless
      POSTGRES_USER: paperless
      POSTGRES_PASSWORD: passwort # Ändere dieses Passwort! Nur Buchstaben, keine Sonderzeichen
    volumes:
      - /volume1/docker/paperless/db:/var/lib/postgresql/data
    networks:
      - paperless-network

  webserver:
    image: ghcr.io/paperless-ngx/paperless-ngx:latest
    container_name: paperless-web
    restart: always
    depends_on:
      - broker
      - db
    environment:
      PAPERLESS_REDIS: redis://broker:6379
      PAPERLESS_DBHOST: db
      PAPERLESS_DBNAME: paperless
      PAPERLESS_DBUSER: paperless
      PAPERLESS_DBPASS: passwort # Passwort muss mit dem PostgreSQL-Passwort übereinstimmen.
      PAPERLESS_SECRET_KEY: thisisarandomsecretkey # Ändere diesen Wert!
      PAPERLESS_URL: http://localhost:8000
      PAPERLESS_ALLOWED_HOSTS: "*"
      PAPERLESS_ADMIN_USER: admin
      PAPERLESS_ADMIN_PASSWORD: passwort # Ändere dieses Passwort!
      UID: 1026 #Standartwerte, ersetze diese durch deine eigene UID
      GID: 100 #Standartwerte, ersetze diese durch deine eigene GID

    volumes:
      - /volume1/docker/paperless/data:/usr/src/paperless/data
      - /volume1/docker/paperless/media:/usr/src/paperless/media
      - /volume1/docker/paperless/export:/usr/src/paperless/export
      - /volume1/docker/paperless/consume:/usr/src/paperless/consume
    ports:
      - 8111:8000
    networks:
      - paperless-network

networks:
  paperless-network:
    driver: bridge

WICHTIG: Ändere die Passwörter bei POSTGRES_PASSWORD: , PAPERLESS_DBPASS: und PAPERLESS_ADMIN_PASSWORD: sowie einen PAPERLESS_SECRET_KEY:
Den Secret Key kannst du bei IT-TOOLS.tech erstellen. UID und GID musst Du ebenfalls mit deinen eigenen Werten ersetzen. Die aktuellen Werte sind Standartwerte und funktionieren bei den meisten Usern. Hier kannst Du deine UID und GID auslesen.


Schritt 4: Projekt starten

  1. Klicke auf weiter und überspringe das Setup über die WebStation (wir konfigurieren alles direkt in der Docker Compose Datei).
  2. Klicke auf Erstellen, um das Projekt zu starten.
  3. Warte, bis alle Container erfolgreich gestartet sind. Du solltest den Status Error Code 0 sehen, was bedeutet, dass alles korrekt läuft.

Schritt 5: Zugriff auf Paperless-ngx

Nachdem das Projekt gestartet wurde, kannst du auf Paperless-ngx zugreifen.

  1. Öffne einen Webbrowser auf deinem Computer oder Smartphone.
  2. Gib die IP-Adresse deines Synology NAS gefolgt vom Port 8111 ein. Zum Beispiel: http://192.168.1.100:8111
  3. Melde dich mit den folgenden Anmeldedaten an:
    • Benutzernameadmin
    • Passwortpasswort (oder das von dir gewählte Passwort).

Schritt 6: Dokumente importieren

Um Dokumente zu importieren, kannst Du sie ganz einfach über drag and drop in das webinterface ziehen oder einfach in den consume-Ordner legen:

/volume1/docker/paperless/consume

Paperless-ngx überwacht diesen Ordner automatisch und importiert neue Dokumente.


Fazit

Herzlichen Glückwunsch! Du hast Paperless-ngx erfolgreich auf deinem Synology NAS installiert. Jetzt kannst du deine Dokumente digitalisieren, organisieren und einfach wiederfinden.

Viel Spaß mit Paperless-ngx!


Hinweis: Denke daran, die Passwörter in der docker-compose.yml-Datei durch sichere, eindeutige Passwörter zu ersetzen. Sicherheit ist wichtig!

(Visited 3.054 times, 27 visits today)
Close