Paperless NGX – Dokumentenarchiv mit OCR aufsetzen

Um einen Paperless NGX-Server aufzusetzen, kannst du eine der häufigsten und komfortablen Methoden wie Docker oder Docker Compose verwenden. Paperless NGX ist eine Open-Source-Lösung zur Verwaltung und Archivierung von Dokumenten. Es ermöglicht die einfache Speicherung, Verwaltung und Suche von Dokumenten, die als PDF oder Bilddateien hochgeladen werden. Hier ist eine Schritt-für-Schritt-Anleitung, um einen Paperless NGX-Server mit Docker Compose aufzusetzen:

Voraussetzungen:

• Ein Linux-Server oder ein Windows/Mac-System mit Docker und Docker Compose installiert.
• Grundkenntnisse in der Bedienung der Kommandozeile.
• Ein Texteditor wie nano oder vim oder ein grafischer Editor, um die docker-compose.yml-Datei zu bearbeiten.

Schritt 1: Installiere Docker und Docker Compose

Falls Docker und Docker Compose noch nicht installiert sind, folge den Anweisungen auf der Docker-Website und Docker Compose-Website. Hier ein Überblick für die Installation unter Ubuntu:

bashCode kopieren# Docker installieren
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io

# Docker Compose installieren
sudo apt-get install docker-compose

Schritt 2: Erstelle ein Verzeichnis für Paperless NGX

Erstelle ein Verzeichnis auf deinem Server, das die Konfigurationsdateien für Paperless NGX enthalten wird:

bashCode kopierenmkdir paperless-ngx
cd paperless-ngx

Schritt 3: Erstelle die docker-compose.yml-Datei

In diesem Verzeichnis erstellst du die docker-compose.yml-Datei. Diese Datei wird Docker anweisen, welche Container gestartet werden sollen und wie sie miteinander interagieren. Erstelle die Datei mit dem folgenden Befehl:

nano docker-compose.yml

Füge die folgende Konfiguration in die Datei ein:

version: "3.8"
services:
  broker:
    image: redis:6.2
    restart: unless-stopped
    volumes:
      - redisdata:/data

  db:
    image: postgres:13
    restart: unless-stopped
    environment:
      POSTGRES_DB: paperless
      POSTGRES_USER: paperless
      POSTGRES_PASSWORD: paperless
    volumes:
      - postgresdata:/var/lib/postgresql/data

  webserver:
    image: ghcr.io/paperless-ngx/paperless-ngx:latest
    restart: unless-stopped
    ports:
      - 8000:8000
    environment:
      PAPERLESS_REDIS: redis://broker:6379
      PAPERLESS_DBHOST: db
      PAPERLESS_DBNAME: paperless
      PAPERLESS_DBUSER: paperless
      PAPERLESS_DBPASS: paperless
      PAPERLESS_TIME_ZONE: Europe/Berlin  # Anpassen an deine Zeitzone
    volumes:
      - ./data:/usr/src/paperless/data
      - ./media:/usr/src/paperless/media
      - ./export:/usr/src/paperless/export
      - ./consume:/usr/src/paperless/consume

volumes:
  redisdata:
  postgresdata:

Erklärung der Konfiguration:

• broker: Redis wird als Message-Broker verwendet, um die asynchrone Verarbeitung der Dokumente zu steuern.
• db: PostgreSQL ist die Datenbank, in der die Daten von Paperless NGX gespeichert werden.
• webserver: Der eigentliche Paperless NGX-Webserver, der den Zugriff auf die Benutzeroberfläche ermöglicht und die Dokumentenverarbeitung übernimmt.
• volumes: Die Verzeichnisse für Redis, PostgreSQL, sowie die Verzeichnisse, in denen Paperless NGX seine Daten speichert.

Schritt 4: Konfigurationsdateien und Verzeichnisse erstellen

Stelle sicher, dass die Verzeichnisse für data, media, export und consume existieren und die richtigen Berechtigungen haben:

mkdir data media export consume

Schritt 5: Paperless NGX starten

Starte die Dienste mit Docker Compose:

docker-compose up -d

Dieser Befehl lädt die benötigten Docker-Images, erstellt Container und startet sie im Hintergrund (-d für detached mode).

Schritt 6: Zugriff auf die Weboberfläche

Sobald die Container gestartet sind, kannst du auf die Weboberfläche von Paperless NGX zugreifen, indem du die IP-Adresse oder den Hostnamen deines Servers im Browser aufrufst, gefolgt von :8000:

http://<deine-server-ip>:8000

Schritt 7: Benutzer erstellen und anmelden

Wenn du Paperless NGX zum ersten Mal startest, musst du einen Admin-Benutzer erstellen, um auf die Weboberfläche zugreifen zu können. Erstelle einen Admin-Benutzer, indem du in den Container des Webservers gehst:

docker-compose exec webserver python3 manage.py createsuperuser

Befolge die Eingabeaufforderungen und gib Benutzernamen, E-Mail-Adresse und Passwort für den neuen Benutzer ein.

Schritt 8: Dateien importieren

• Verzeichnis consume: Ziehe Dokumente in den Ordner consume, damit sie automatisch in Paperless NGX importiert werden.
• Weboberfläche: Alternativ kannst du Dokumente direkt über die Benutzeroberfläche hochladen.

Schritt 9: Backup und Wartung

• Backups: Erstelle regelmäßig Backups der postgresdata und media-Verzeichnisse, um Datenverluste zu vermeiden.
• Updates: Aktualisiere die Docker-Container regelmäßig, indem du die Images neu herunterlädst und die Container neu startest:

docker-compose pull
docker-compose down
docker-compose up -d

Zusammenfassung

Mit diesen Schritten hast du einen funktionierenden Paperless NGX-Server aufgesetzt. Dies ermöglicht dir die zentrale Verwaltung und Archivierung von Dokumenten. Paperless NGX bietet eine mächtige Suchfunktion, OCR (Texterkennung), und eine intuitive Weboberfläche, die die Verwaltung von gescannten Dokumenten deutlich erleichtert.