Praxisnahe Tutorials, auf die du zählen kannst.
Einsteiger Guide für Home Assistant

NIE WIEDER Papierkram suchen! 😱 Paperless-NGX in der Praxis

Schluss mit dem Papierchaos! 📁 In diesem Video zeige ich dir, wie Paperless-NGX dein digitales Dokumentenmanagement revolutioniert. Erfahre, wie du mit diesem Open-Source-Tool ganz einfach Rechnungen, Verträge und wichtige Unterlagen scannen, organisieren und blitzschnell wiederfinden kannst. Perfekt für Home Assistant Nutzer und alle, die endlich papierlos und effizient arbeiten wollen! 🚀

Inhaltsverzeichnis

Was ist Paperless-ngx?

Paperless-ngx ist ein Open-Source-Dokumentenmanagementsystem, das darauf abzielt, physische Dokumente in ein digitales, durchsuchbares Archiv umzuwandeln. Es bietet Funktionen wie OCR-Texterkennung, automatische Kategorisierung, Volltextsuche und Workflow-Automatisierung. Die Software eignet sich sowohl für private Nutzer als auch für Unternehmen und unterstützt die Integration mit anderen Systemen wie E-Mail-Clients und CRM-Anwendungen.

Zu den Vorteilen zählen eine benutzerfreundliche Oberfläche, flexible Such- und Filteroptionen sowie die Möglichkeit, Dokumente mobil oder in der Cloud zu verwalten. Paperless-ngx ist skalierbar und optimiert für Multi-Core-Systeme, wodurch parallele Verarbeitung von Dokumenten möglich ist.

Wir schauen uns hier die Installation von Paperless als Home Assistant Add-on an, da so der Einstieg deutlich einfacher ist als ein eigenes System dafür aufzusetzen.

Voraussetzungen

Home Assistant solltest du bereits installiert haben, bevorzugt auf Proxmox oder einer anderen, performanten Hardware, wie dem Raspberry Pi 5 oder einem Mini-PC.

Alternative zur Home Assistant Installation

Alternativ kannst du natürlich auch einen Paperless-Container direkt auf Proxmox installieren, allerdings solltest du dir dann dringen Gedanken über die Erreichbarkeit von unterwegs machen (wenn du das möchtest) sowie Backups 😉

Die Skripte zur Installation findest du auch im Proxmox-Beitrag, hier die URL: https://community-scripts.github.io/ProxmoxVE/

Das Paperless-Skript hier: https://community-scripts.github.io/ProxmoxVE/scripts?id=paperless-ngx

Repository für Paperless (Benoit Anastay)

https://github.com/BenoitAnastay/home-assistant-addons-repository

Open your Home Assistant instance and show the add add-on repository dialog with a specific repository URL pre-filled.

Danke an SwtichBot

Vielen Dank nochmal an SwitchBot für das Sponsorn des Videos. Check den Luftreiniger gerne mal aus, noch mit ein paar mehr technischen Daten die es nicht ins Video geschafft haben:

SwitchBot Air Purifier

Der smarte Luftreiniger mit Tisch & HEPA-Filter
Zu SwitchBot* → Gutschein: SIMON42

Technische Daten

AnwendungsbereicheHilft, Haare, Pollen, Allergene, PM2.5, Gerüche und andere Schadstoffe in Zimmern zu entfernen.
SKUJP/US/EU/UK/CA
Größe250 × 250 × 490 mm
Nettogewicht4434 g
Verpackungsgröße297 × 297 × 608 mm
Gewicht mit Verpackung5515 g
MaterialienMaterial: ABS + PC
Vorfilter40-50 Maschen-Gaze, abnehmbar zum Waschen oder Staubsaugen
HEPA-FilterFängt Partikel mit einem Durchmesser von 0,1-0,3 Mikrometern ein, Filtrationseffizienz von 99,97%, CADR: 236 CFM = 400 m³/h Austauschintervall: 6 bis 12 Monate, Lebensdauer wird über die App aufgezeichnet
GeruchsneutralisationHaustierfreundliche Aktivkohle, speziell gegen Ammoniak, Schwefelwasserstoff, Methylmercaptan, Trimethylamin und Essigsäure 1m³-Testkammer, Geruchsbeseitigungsrate > 95% in einer halben Stunde Austauschintervall: 12 Monate, Lebensdauer wird über die App aufgezeichnet
Anwendungsbereich33 m² (360 ft²)
GeräuschpegelNiedrigste Lüftergeschwindigkeit: ≤20 dB (Schalldruckpegel) Höchste Lüftergeschwindigkeit: ≤52 dB (Schalldruckpegel)
MotorBürstenloser Gleichstrommotor
LuftqualitätssensorInfrarot-Staubsensor (PM2.5)
Lichtsensor
UmgebungslichtZeigt die Luftqualität mit verschiedenen Farben an, kann angepasst werden, unterstützt 10 Farben
Aromapad-BoxErmöglicht das Hinzufügen ätherischer Öle
WLAN/Bluetooth-Modul
Standby-Leistung<0,5 W bei deaktiviertem WLAN, <2 W bei aktiviertem WLAN
Nennleistung40 W, 15 W für die kabellose Ladeeinheit
Nutzung mit der SwitchBot Mobile Base1 Stunde Akkulaufzeit bei höchster Lüftergeschwindigkeit
TischplatteGröße: 250 × 250 mm Belastbarkeit: 5 kg (laut Handbuch) Temperaturbeständigkeit: 114°C

Empfehlungen für Scanner

Zuletzt aktualisiert am 13.03.2025 um 18:50 . Wir weisen darauf hin, dass sich hier angezeigte Preise inzwischen geändert haben können. Alle Angaben ohne Gewähr.
Zuletzt aktualisiert am 12.03.2025 um 17:50 . Wir weisen darauf hin, dass sich hier angezeigte Preise inzwischen geändert haben können. Alle Angaben ohne Gewähr.

FAQ

Ja, dafür unter Einstellungen -> Dokumentenbearbeitung -> Posteingangs-Tag(s) beim Speichern automatisch entfernen einstellen.

Danke an @dcf7900 für den Tipp 🎉

Ja, dafür in den Einstellungen (Home Assistant → Einstellungen → System → Speicher → Netzwerkspeicher) einfach einen Netzwerkspeicher unter dem Namen paperless mounten 👍

Nach dem Start des Addons, wird dann dieser Ordner für die Dokumente und die eingehenden Dokumente verwendet.

Hinweis: Der Ordner paperless darf im Home Assistant Ordner Share beim Hinzufügen des Netzwerkspeichers noch nicht existieren!

Solltest du das Add-on also schon am Laufen haben, musst du:

  1. Alles unter /share/paperless von deinem Home Assistant in den Ordner auf deinen Netzwerkspeicher kopieren
  2. Den Ordner paperless unter share auf deinem Home Assistant löschen
  3. Und jetzt erst den Netzwerkspeicher verbinden, damit der Ordner “paperless” über den Netzwerkspeicher neu gemountet werden kann!

Es gibt auch günstigere, ja. Aber, hier nur mal ein Beispiel: Meine Schwiegereltern hatten den 1600 & der ist mittlerweile auf dem Müll gelandet, weil immer wieder Seiten doppelt eingezogen, Dokumente nicht richtig gehalten wurden und man dann sogar mit dem Smartphone schneller war.

Daher empfehle ich dir hier nur Modelle, die sich wirklich lohnen. Im Zweifel kannst du auch erstmal den ADS-1800* probieren und wenn du nicht zufrieden bist später immer noch upgrade. Sag aber nicht, ich hätte dich nicht gewarnt 😉

Ja, das ist möglich. Wenn du bisher einen normalen User mit Login und Kennwort genutzt hast, musst du zuerst die Ingress-Authentifizierung aktivieren.

Anschließend wartest du 2-3 Minuten und klickst dann in der Seitenleiste von HA auf Paperless-NGX, um die UI aufzurufen. Hier wird ein Fehler erscheinen und du wirst keine Dokumente sehen!

Folgende Schritte musst du nun ausführen:

  1. Deaktiviere Ingress-Authentifizierung wieder
  2. Melde dich mit dem “alten” nutzer (also mit Nutzername und Passwort) in Paperless an
  3. Gehe in Paperless auf Benutzer und Gruppen und wähle Bearbeiten neben deinem neuen User
  4. Hier vergibst du die entsprechenden Rechte, für einen Admin wie folgt:

Hinweis: Bei dir ist wahrscheinlich nur Benutzername gefüllt, den Rest habe ich so eingetippt.

Beachte alternativ den nächsten Punkt 👇 um explizitere Rechte zu vergeben.

Ja, Paperless bringt auch eine Benutzer und Gruppenverwaltung mit!

Diese kann man unter Paperless in den Einstellungen anlegen (oder verwalten, wenn “Ingress Authentication” aktiviert ist).

Hier kann man eigene Gruppen anlegen und dann diese Gruppe (oder auch direkt die Nutzer) beispielsweise an den Einstellungen von Schlagwörtern zum anzeigen berechtigen.

Alternativ kann man den Nutzern auch einfach unter Einstellungen -> Berechtigungen Standard-Anzeigeberechtigungen vergeben. Allerdings ist das Berechtigen auf Tags natürlich granularer, als das Recht zur Anzeige aller Dokumente 😉

Ja, du musst dafür in den Add-on-Einstellungen den HTTP-Port aktivieren und danach beispielsweise über Cloudflare (Add-on für HA) eine Subdomain für diesen zusätzlichen Service einrichten. Danach in der App die Subdomain eingeben, User & Kennwort eingeben, fertigt 👍

Das hatte ich auch am Ende des Cloudflare-Videos schon mal allgemein erklärt.

Einstellungen im Paperless Add-on 👆

Einstellungen im Cloudflare Add-on 👆

Danach kannst du dich in der App über die URL https://paperless.deine-domain.com an deinem Paperless anmelden.

Achtung: Es kann sein, dass dieser Zugriff auf Paperless gegen die ToS von Cloudflare für kostenfreie Tunnel verstößt.

Fazit

Mit Paperless-NGX wird die Dokumentenverwaltung zum Kinderspiel und das lästige Suchen nach Papierkram gehört der Vergangenheit an. Die einfache Handhabung und die Installation als Addon in Home Assistant bieten zahlreiche Vorteile für einen schnellen Start.

Nutze die Möglichkeiten dieser leistungsstarken Software, um deine Unterlagen effizient zu organisieren und Zeit zu sparen!

Verpasse keine Tipps!

Ich sende keinen Spam! Erfahre mehr in der Datenschutzerklärung.

Transparenz: In diesem Artikel sind Partnerlinks enthalten. Durch einen Klick darauf ge­lan­gt ihr direkt zum Anbieter. Solltet ihr euch dort für einen Kauf entscheiden, erhalte ich ei­ne kleine Provision. Für euch ändert sich am Preis nichts & Partnerlinks haben keinerlei Einfluss auf meine Berichterstattung. Vielen Dank für deine Unterstützung!

Gründer von simon42. Schreibt hier ehrlich und leidenschaftlich über Smart Home und Technik Themen, denn das Zuhause wurde bereits von Sprachassistenten übernommen und die Kontrolle abgegeben 😁

Nennenswerte Antworten

  1. Wo finde ich denn den Link zum Repo?
    Unter der Video Beschreibung finde ich nichts oder bin blind :grin:

  2. Ich finde, das ist ein tolles Projekt. Meine Instanz läuft unter Proxmox auf einem LXC mit Docker. Auf eine Installation auf Home Assistant habe ich verzichtet, da sich mit der Zeit viele Dokumente ansammeln und das Backup entsprechend groß wird. Ich bin jetzt bei 1700 Dokumenten und einem Backupvolumen von 5 GB.

    Ich habe mich auch für die Docker-Lösung entschieden, weil es mit Docker-Copose noch eine Erweiterung gibt, mit der auch JPG, EML, DOCX etc. eingelesen werden können.

    Ein wichtiger Punkt, den Simon auch erwähnt hat, ist, dass man sich wirklich überlegen muss, welche Dokumenttypen man braucht. Ich bin auf 22 Typen gekommen, die ich auch brauche. Das hat mich einige Stunden gekostet.

    Den Zugriff von außen stelle ich über VPN, Nginx und Local DNS sicher.

  3. Das funktioniert nicht. Finde paperless über den add in Store nicht.

  4. Moin,

    Ich auch, aber ohne Docker :wink:
    Und alles das Office Dokumente sind, werden durch Tika / Gotenberg aufbereitet, laufen bei mir aber auch normal im LXC.

    Ich habe mir vieles hier abgeschaut

    VG
    Bernd

    Dann schau mal was kommt, wenn Du die URL im Browser einfügst

    HA mal neu starten

    VG
    Bernd

Setze die Diskussion fort unter community.simon42.com

18 mehr antworten

Teilnehmer

Avatar for system Avatar for guezli Avatar for helmut Avatar for Statusbit Avatar for Wolf2000 Avatar for tarag Avatar for dp20eic Avatar for Wolfi1 Avatar for N3RO365 Avatar for Magicdragon67 Avatar for Steff79 Avatar for MaRo8

Die Kommentare sind geschlossen.

Send this to a friend