Praktische Erfahrungen aus dem IT-Alltag

Schlagwort: paperless-ngx

  • Import von .xls/.xlsx in paperless-ngx: „datetime out of representable range“

    Kürzlich hatte ich ein Dokument, welches von paperless-ngx mit dem Erstellungsdatum 01.01.1601 erkannt wurde. Versteckte Metadaten in einer alten XLS-Datei sorgten offenbar dafür, dass der Parser von paperless-ngx das falsche Erstellungsdatum als Erstellungsdatum in die in meinem beispielhaften Fall SQLite-basierte paperless-ngx-Datenbank, einzutragen versuchte.

    2009-01-01 Klassenkasse 6a.xlsx: The following error occurred while storing document 2009-01-01 Klassenkasse 6a.xlsx after parsing: datetime out of representable range

    Denkbar ist, dass diese Datei um 2009 herum mit einer bereits damals veralteten Excel-Version erstellt wurde. Jedoch brachte auch eine Konvertierung in das aktuellste XLSX-Format hier keine Hilfe, obwohl dies naheliegend wäre.

    Am Ende half es, die Datei in Excel zu öffnen:

    Datei -> Informationen -> „Auf Probleme überprüfen“ -> „Dokument prüfen“ -> „Prüfen“ -> bei Funden „Alle entfernen“

    Anschließend ließ sich die Datei einwandfrei importieren und produzierte keine Fehler mehr. Das angegebene Datum des 01.01.2009 war das über die normalen Metadaten abrufbare Datum, welches eigentlich hätte verwendet werden sollen.

  • Volltextsuche funktioniert nach Upgrade auf paperless-ngx 3.x nicht mehr

    Maßgeblich hierfür ist eine Änderung in paperless-ngx oder vielmehr ein Wechsel einer bestimmten Python-Bibliothek auf eine andere, bei der die Indexierungsdaten nicht kompatibel sind.

    Nach einem Update auf paperless-ngx 3.x muss ein Reindex wie folgt durchgeführt werden. (Das Beispiel bezieht sich auf das Docker-Setup für paperless-ngx aus der offiziellen Anleitung.)

    cd paperless-ngx
docker compose exec -ti webserver python3 manage.py document_index reindex --recreate
docker compose restart webserver

    Nach erfolgreicher Durchführung sollte die Volltextsuche im paperless-ngx-Webinterface sofort wieder funktionieren.

  • paperless-ngx: Verschlüsselung at rest einrichten

    Seit Version 0.90 gibt es in paperless-ngx keine eingebaute Verschlüsselungsfunktion mehr. Das wurde damit begründet, dass diese Verschlüsselung zwar davor schützt, dass z. B. durch File-Carving wiederherzustellende Datenteile geschützt würden, jedoch die Verschlüsselung nicht vor Diebstahl des Mediums schütze, da die Verschlüsselungsschlüssel weiterhin lesbar vorlägen.

    (mehr …)

  • paperless-ngx: Dateistruktur nachträglich aus Docker Volumes in ein einheitliches Verzeichnis zusammenfassen

    Wenn man den Installationsprozess von paperless-ngx im Schnelldurchlauf vollzogen hat, hat paperless-ngx mehrere Docker Volumes in seinem docker-compose.yml angelegt:

    • pgdata
    • media
    • data
    • redisdata

    Um diese nachträglich in eine einheitliche Ordnerstruktur zusammenzufassen, z. B. zum leichteren Export des gesamten Docker-Compose-Stacks, gehen wir wie folgt vor.

    (mehr …)

  • paperless-ngx: Bei Hetzner Cloud-Server tägliche Backups aktivieren

    Nachdem wir unsere paperless-ngx Installation auf dem Hetzner Cloud-Server installiert haben, sind Sicherungen unverzichtbar. Sie schützen uns vor möglichen Datenverlusten. In einer anderen Variante werde ich ein anbieterunabhängiges Backup beschreiben, in diesem Artikel nutzen wir die mit Abstand einfachste Variante: Tägliche Backups über die von Hetzner angebotene Infrastruktur.

    (mehr …)

  • paperless-ngx: Auf Hetzner Cloud-Server eigene Domain einrichten

    Ist auf einem virtuellen Server, vgl. Hetzner Cloud-Server, einmal paperless-ngx aufgesetzt, sind gute Voraussetzungen geschaffen, vom bloßen Zugriff über eine IP im Browser auf eine menschenlesbare und -merkbare Domain zu wechseln.

    Dazu bedarf es einer Domain von einem Domainregistrar. Hiervon gibt es viele, die sich lediglich in der Verwaltung der Domain und im Preis unterscheiden. Anfängerkompatibel sind u. A.:

    • DomainFactory
    • United-Domains
    • Strato
    • viele mehr, Recherche lohnt sich unter Umständen
    (mehr …)