Paperless-ngx auf Linux Mint

 

Paperless-ngx auf Linux Mint: Der ultimative Guide zum papierlosen Büro

Linux Mint ist dank seiner Stabilität die ideale Basis für einen Heimserver oder eine Dokumentenverwaltung. Mit Paperless-ngx verwandelst du deinen PC in ein intelligentes Archiv, das Dokumente scannt, per OCR (Texterkennung) lesbar macht und automatisch kategorisiert.

Schritt 1: Das System vorbereiten

Bevor wir Paperless installieren, benötigen wir Docker. Docker sorgt dafür, dass Paperless in einer isolierten Umgebung läuft, ohne dein Mint-System mit unzähligen Abhängigkeiten zu belasten.

1. System aktualisieren: Öffne das Terminal und bringe alles auf den neuesten Stand:

   sudo apt update && sudo apt upgrade -y

2. Docker und Docker Compose installieren:

   sudo apt install docker.io docker-compose-v2 -y

3. Berechtigungen anpassen: Damit du Docker ohne sudo nutzen kannst, füge deinen Benutzer der Docker-Gruppe hinzu:

   sudo usermod -aG docker $USER

   Wichtig: Starte den Rechner neu oder melde dich einmal ab und wieder an, damit diese Änderung greift.

---

Schritt 2: Die Installation (Der interaktive Weg)

Die Entwickler bieten ein Skript an, das die gesamte Arbeit für dich erledigt. Es fragt dich nach Pfaden und Passwörtern.

1. Skript starten:

   bash -c "$(curl -L https://raw.githubusercontent.com/paperless-ngx/paperless-ngx/main/install.sh)"

2. Wichtige Abfragen im Skript:

   • Target folder: Wo sollen die Daten liegen? (z. B. /home/DEINNAME/paperless-ngx)

   • OCR language: Gib hier deu ein (für Deutsch). Du kannst auch mehrere angeben, z. B. deu+eng.

   • Database: Wähle PostgreSQL (das ist der Standard und sehr stabil).

   • Superuser: Erstelle hier deinen Admin-Account (Name, E-Mail, Passwort). Dieses Passwort brauchst du später für den Login im Browser.

---

Schritt 3: Konfiguration verfeinern

Nachdem das Skript fertig ist, navigiere in den Ordner. Dort liegt eine Datei namens docker-compose.env. Diese kannst du mit dem Texteditor (Xed) bearbeiten:

xed docker-compose.env

Empfohlene Einstellungen:

• PAPERLESS_TIME_ZONE=Europe/Berlin: Damit die Zeitstempel deiner Dokumente stimmen.

• PAPERLESS_FILENAME_FORMAT={created_year}/{correspondent}/{title}: Das sorgt dafür, dass Paperless deine PDFs auch auf der Festplatte in einer ordentlichen Ordnerstruktur ablegt (Jahr -> Absender -> Titel).

Speichere die Datei und starte die Container neu, falls sie schon laufen:

docker compose up -d

---

Schritt 4: Die Mint-Integration (Profi-Tipps)

Der "Consume"-Ordner in Nemo

Paperless überwacht einen speziellen Ordner ("consume"). Alles, was du dort hineinschiebst, wird sofort importiert.

• Tipp: Öffne deinen Dateimanager Nemo, geh zu deinem Paperless-Ordner, klicke rechts auf den Ordner consume und wähle "Zu Lesezeichen hinzufügen". So hast du ihn immer in der Seitenleiste.

Paperless als "Desktop-App"

In Linux Mint gibt es das Tool Web-Apps.

1. Suche im Startmenü nach "Web-Apps".

2. Klicke auf das "+"-Symbol.

3. Name: Paperless-ngx, Adresse: http://localhost:8000.

4. Wähle ein schönes Icon aus. Ergebnis: Du kannst Paperless jetzt wie ein normales Programm über dein Startmenü aufrufen, ohne erst den Browser öffnen zu müssen.

---

Schritt 5: Wartung und Backups

Ein papierloses Büro ist nur so gut wie sein Backup.

• Updates einspielen:

  docker compose pull

  docker compose up -d
  

• Backup der Datenbank: Sichere regelmäßig den Inhalt des Export-Ordners. Du kannst manuell einen Export aller Daten (inkl. Metadaten) anstoßen:

  docker compose exec webserver document_exporter ../export

---

Fazit

Die Kombination aus der Benutzerfreundlichkeit von Linux Mint und der Mächtigkeit von Paperless-ngx ist unschlagbar. Nach der Ersteinrichtung läuft das System fast wartungsfrei im Hintergrund.

Viel Erfolg beim Digitalisieren!

erstellt am 16.03.2026