{"id":21002,"date":"2025-11-01T20:49:56","date_gmt":"2025-11-01T19:49:56","guid":{"rendered":"https:\/\/linux-bibel.at\/?p=21002"},"modified":"2025-11-01T20:56:03","modified_gmt":"2025-11-01T19:56:03","slug":"paperless-ngx-das-papierlose-buero-unter-linux","status":"publish","type":"post","link":"https:\/\/linux-bibel.at\/index.php\/2025\/11\/01\/paperless-ngx-das-papierlose-buero-unter-linux\/","title":{"rendered":"Paperless-NGX – das papierlose B\u00fcro unter Linux"},"content":{"rendered":"\n

Nachdem viele Leser auf der Linux<\/a> Bibel nach der Software Paperless-NGX suchen, habe ich mir gedacht – ich verfasse dazu einen kurzen Artikel. <\/p>\n\n\n\n

Gleich einmal zu Beginn – worum geht es bei Paperless (NGX lasse ich im Rest des Artikels weg<\/em>)? Schnell und einfach gesagt – um eine Software, mit der Sie Ihre Dokumente in ein durchsuchbares Archiv<\/a> verlegen. Dies bedeutet – Sie scannen Ihre Hardware-Dokumente aus Papier ein, fügen diese dann als Bilder in Paperless ein, Paperless erstellt daraus mittels OCR (Optischer Texterkennung<\/em>) ein Archiv<\/a>, das Sie nach Text durchsuchen können.<\/p>\n\n\n\n

Paperless installieren<\/h3>\n\n\n\n

Die Installation erfolgt via Docker<\/a> oder Podman – ganz ehrlich, einfacher geht es nicht, ansonsten müssten Sie die ganzen Abhängigkeiten und Einstellungen selbst einklopfen. Sie installieren sich also Docker<\/a> und Docker<\/a>-Compose oder Podman und Podman-Compose über die Paket<\/a>-Verwaltung Ihrer genutzten Linux<\/a>-Distribution<\/a> – unter auf Debian<\/a> basierenden Linux<\/a>-Distribution<\/a>en also am schnellsten als root<\/a> auf dem Terminal<\/a>:<\/p>\n\n\n\n

apt update\napt install docker.io docker-compose<\/code><\/pre>\n\n\n\n
Oder eben:<\/p>\n\n\n\n
apt update\napt install podman podman-compose<\/code><\/pre>\n\n\n\n
Da die meisten noch immer Docker<\/a> verwenden, wird die Geschichte hier über Docker<\/a> geregelt, für Podman gibt es eine kurze Umschreibung.<\/p>\n\n\n\n
Als Erstes benötigen Sie von GitHub<\/a> drei Datei<\/a>en – Paperless braucht eine Datenbank<\/a>, diese wird gleich als Container eingebaut. Diese Datenbank<\/a> kann sein – SQLite<\/strong> (für sehr kleine Archiv<\/a>e<\/em>), MySQL<\/a><\/strong> (ist träge, aber für größere Archiv<\/a>e<\/em>) und PostgreSQL<\/strong> (für große Archiv<\/a>e<\/em>). Da man für kleine Archiv<\/a>e nicht unbedingt ein solches Verwaltungssystem braucht, nehmen wir gleich eine richtige Datenbank<\/a> – Postgres.<\/p>\n\n\n\n
Sie benötigen für dieses Szenario folgende drei Datei<\/a>en: „.<\/a>env<\/a> docker-compose.env<\/a><\/strong> und docker-compose.postgres.yml<\/strong><\/a>„. Diese drei Datei<\/a>en speichern<\/a> Sie in einem Verzeichnis<\/a> – dieses Verzeichnis<\/a> wird auch nach der Installation von Paperless nicht gelöscht! In meinem Fall unter Browser Chrome, wurde die Datei<\/a> „.env<\/strong>“ als „env.txt<\/strong>“ heruntergeladen – benennen Sie diese um, etwa per Mausklick oder auf dem Terminal<\/a>:<\/p>\n\n\n\n
mv env.txt .env<\/code><\/pre>\n\n\n\n
Die Datei<\/a> „docker<\/a>-compose.postgres.yml<\/strong>“ wird in „docker<\/a>-compose.yml<\/strong>“ umbenannt. Jetzt öffnen Sie die Datei<\/a> „docker<\/a>-compose.yml<\/strong>“ in einem Texteditor<\/a> – standardmäßig läuft Paperless auf einem Webserver<\/a> (ebenfalls integriert<\/em>), auf Port „8000<\/strong>“ – möchten Sie dies ändern – etwa, weil Sie auf diesem Port schon etwas laufen haben. Soll Ihr Paperless auch außerhalb Ihres lokalen Netzwerk<\/a>es erreichbar sein, ändern Sie hier auch:<\/p>\n\n\n\n