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 09.06.2025 um 19:11 . Wir weisen darauf hin, dass sich hier angezeigte Preise inzwischen geÀndert haben können. Alle Angaben ohne GewÀhr.
Zuletzt aktualisiert am 09.06.2025 um 19:11 . Wir weisen darauf hin, dass sich hier angezeigte Preise inzwischen geÀndert haben können. Alle Angaben ohne GewÀhr.

FAQ

Auch Paperless (wie alle Add-ons ĂŒbrigens) wird beim Home Assistant Backup gesichert!

Wichtig ist nur, dass ein vollstÀndiges Backup erstellt wird oder alternativ das Add-on Paperless & der Ordner Share.

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

169 mehr antworten

Teilnehmer

Avatar for guezli Avatar for Statusbit Avatar for Soul Avatar for daschmidt Avatar for Shadow31 Avatar for Wolf2000 Avatar for revls Avatar for dp20eic Avatar for Wolfi1 Avatar for Op3ra7or262 Avatar for harwin Avatar for N3RO365 Avatar for Alf Avatar for Schwingsi Avatar for tukane Avatar for Bacardi Avatar for HansWurst4540 Avatar for Balderich Avatar for Steff79 Avatar for kulturschock Avatar for anon99644385 Avatar for HAndy Avatar for snooty83 Avatar for wgretzke

Die Kommentare sind geschlossen.