Paperless-ngx: Koniec chaosu s dokumentmi

Ako každý, mal som dokumenty rozsypané všade. Časť žila v Gmaili, niečo na Google Drive, fyzické faktúry v škatuli niekde v skrinke, fotky dokladov v mobile. A keď som niečo potreboval nájsť — záručný list alebo starú faktúru — vždy to trvalo dlhšie, než by malo. Začal som hľadať riešenie a narazil som na Paperless-ngx.

Prvý raz som ho skúšal pred asi dvomi rokmi. Musím byť úprimný — vtedy to nebolo také jednoduché. Rozhranie bolo menej vybrúsené a nastavenie niektorých vecí si vyžadovalo viac trpezlivosti. Dnes je to iná liga. A navyše — pribudla AI, ktorá zmenila hru.

Ako dostať dokumenty dnu

Toto bola moja prvá otázka: ako preniesť roky nahromadených dokumentov do jedného systému bez toho, aby som stratil prehľad? Ukázalo sa, že Paperless-ngx má na to viac spôsobov naraz.

Gmail / Email

Automatické sťahovanie príloh cez IMAP

→

Web / Drag & Drop

Priamo do prehliadača

→

Mobilná app

Odfotiť a odoslať na mieste

→

Paperless OCR

Automatická analýza a rozpoznanie textu

Prepojenie s Gmailom funguje cez Google App Password — bežné heslo tu nestačí, keďže Gmail vyžaduje špeciálne heslo aplikácie pre IMAP prístup. Nastavíš ho raz v Google účte a Paperless si odtiaľ automaticky sťahuje prílohy podľa tvojich pravidiel. Nová faktúra príde emailom? Paperless ju stiahne, analyzuje a zaradí — bez tvojho zásahu.

Fyzické dokumenty riešim cez mobilnú aplikáciu. Odfotím a odošlem — OCR sa postará o zvyšok. Formáty PDF, Word, Excel, obrázky — Paperless rozpozná všetko.

Čo je OCR?

Optical Character Recognition — technológia, ktorá z obrázku alebo skenu vytvorí prehľadávateľný text. Vďaka tomu môžeš v Paperless vyhľadávať aj v naskenovaných dokumentoch, nielen v natívnych PDF.

Kategorizácia a tagy — poriadok, ktorý funguje

Keď sú dokumenty v systéme, treba ich usporiadať. Paperless používa kombináciu korešpondentov (kto dokument poslal), typov dokumentov (faktúra, zmluva, záručný list…) a tagov. Spolu to tvorí systém, v ktorom sa dá veľmi rýchlo zorientovať.

Keď som začínal, prešiel som ručne niekoľko týždňov starých dokumentov a všetkému som priraďoval kategórie manuálne. Fungovalo to, ale bolo to zdĺhavé. Dnes by som to spravil za pár hodín — vďaka AI.

AI + Paperless: ďalší level

Toto je miesto, kde sa Paperless-ngx mení z dobrého nástroja na výnimočný. Cez Open WebUI môžeš napojiť lokálny alebo cloudový jazykový model priamo na tvoju knižnicu dokumentov.

Funguje to cez jednoduchý Python skript — paperless-bridge — ktorý sprístupní Paperless API pre LLM. Model potom dokáže automaticky navrhovať kategórie, tagy a korešpondentov pre nové dokumenty, alebo ti jednoducho odpovedať na otázky typu: "Kedy mi vyprší záruka na práčku?" alebo "Koľko som zaplatil za elektrinu minulý rok?"

Ja používam Claude Haiku cez API — je rýchly, lacný a na kategorizáciu dokumentov viac než dostatočný. Ak nemáš cloudové API, funguje aj lokálne cez Ollama, len potrebuješ dostatočný hardware. Celé nastavenie je popísané v samostatnom článku.

Chceš napojiť AI na Paperless?

Pripravil som kompletný návod — Open WebUI, Python bridge, prepojenie s Claude Haiku alebo lokálnym Ollama modelom. Krok za krokom od inštalácie po prvé inteligentné vyhľadávanie.

Paperless-AI — návod →

Pre koho je Paperless-ngx?

SZČO a živnostníci

Faktúry, daňové doklady, zmluvy — všetko v poriadku a kedykoľvek dohľadateľné.

Rodiny

Záručné listy, poistky, doklady k nehnuteľnostiam — žiadna škatuľa v skrini.

IT nadšenci

Plná kontrola nad dátami, self-hosted, REST API, integrácia s čímkoľvek.

Home office

Centralizovaná správa dokumentov bez predplatného cloudových riešení.

Mobilní používatelia

Odfotiť doklad na mieste, systém sa postará o kategorizáciu.

Privacy-first

Žiadny cloud tretej strany. Dokumenty zostávajú výhradne u teba.

Čo som zistil po dvoch rokoch

Paperless-ngx nie je len digitálny archív. Je to systém, ktorý sa zlepšuje s tým, ako ho používaš — čím viac dokumentov má, tým lepšie navrhuje kategórie a korešpondentov. A s AI integráciou to prestalo byť len o ukladaní — začal som sa aktívne pýtať na obsah svojich dokumentov.

Dnes mi trvá nájdenie akéhokoľvek dokumentu menej ako 10 sekúnd. Škatuľa so záručnými listami stále stojí v skrinke, ale posledný raz som do nej siahol pred viac ako rokom.

⚠️ Zálohovanie

Paperless-ngx je self-hosted riešenie — za zálohy zodpovedáš ty. Dôrazne odporúčam nastaviť automatické zálohovanie databázy aj priečinka s dokumentmi, ideálne na externé médium alebo offsite.

Chceš Paperless-ngx nainštalovať?

Pripravil som kompletný inštalačný návod — Docker stack pre Synology NAS, Linux aj Windows, s databázou MariaDB, nastavením OCR a prvým spustením.

Paperless-ngx — návod na inštaláciu →

Wie jeder hatte ich meine Dokumente überall verstreut. Ein Teil lebte in Gmail, etwas auf Google Drive, physische Rechnungen in einer Schachtel irgendwo im Schrank, Fotos von Belegen im Handy. Und wenn ich etwas brauchte — einen Garantieschein oder eine alte Rechnung — hat es immer länger gedauert als nötig. Ich fing an, nach einer Lösung zu suchen, und stieß auf Paperless-ngx.

Das erste Mal habe ich es vor etwa zwei Jahren ausprobiert. Ich muss ehrlich sein — damals war es nicht so einfach. Die Oberfläche war weniger ausgereift und die Einrichtung erforderte mehr Geduld. Heute ist es eine andere Liga. Und außerdem — die KI kam hinzu und hat das Spiel verändert.

Wie man Dokumente ins System bekommt

Das war meine erste Frage: Wie bringe ich jahrelang angehäufte Dokumente in ein System, ohne den Überblick zu verlieren? Es stellte sich heraus, dass Paperless-ngx dafür mehrere Wege gleichzeitig bietet.

Gmail / E-Mail

Automatischer Anhang-Download via IMAP

→

Web / Drag & Drop

Direkt im Browser

→

Mobile App

Foto aufnehmen und sofort senden

→

Paperless OCR

Automatische Analyse und Texterkennung

Die Verbindung mit Gmail funktioniert über ein Google App Password — das normale Passwort reicht hier nicht, da Gmail für IMAP-Zugriff ein spezielles App-Passwort erfordert. Du richtest es einmal in deinem Google-Konto ein, und Paperless lädt Anhänge automatisch nach deinen Regeln herunter. Neue Rechnung per E-Mail? Paperless lädt sie herunter, analysiert und sortiert sie — ohne dein Zutun.

Physische Dokumente löse ich über die mobile App. Fotografieren und absenden — OCR erledigt den Rest. Formate wie PDF, Word, Excel, Bilder — Paperless erkennt alles.

Was ist OCR?

Optical Character Recognition — Technologie, die aus einem Bild oder Scan durchsuchbaren Text macht. Damit kannst du in Paperless auch in eingescannten Dokumenten suchen, nicht nur in nativen PDFs.

Kategorisierung und Tags — Ordnung, die funktioniert

Sobald Dokumente im System sind, müssen sie geordnet werden. Paperless verwendet eine Kombination aus Korrespondenten (wer das Dokument gesendet hat), Dokumenttypen (Rechnung, Vertrag, Garantieschein…) und Tags. Zusammen ergibt das ein System, in dem man sich sehr schnell zurechtfindet.

Als ich anfing, habe ich wochenlang manuell alte Dokumente durchgearbeitet und alles manuell kategorisiert. Es hat funktioniert, war aber zeitaufwändig. Heute würde ich das in ein paar Stunden erledigen — dank KI.

KI + Paperless: das nächste Level

Hier verwandelt sich Paperless-ngx von einem guten Werkzeug in ein außergewöhnliches. Über Open WebUI kannst du ein lokales oder cloudbasiertes Sprachmodell direkt mit deiner Dokumentenbibliothek verbinden.

Es funktioniert über ein einfaches Python-Skript — paperless-bridge — das die Paperless-API für das LLM zugänglich macht. Das Modell kann dann automatisch Kategorien, Tags und Korrespondenten für neue Dokumente vorschlagen oder Fragen beantworten wie: „Wann läuft meine Garantie auf die Waschmaschine ab?" oder „Wie viel habe ich letztes Jahr für Strom bezahlt?"

Ich verwende Claude Haiku über die API — schnell, günstig und für die Kategorisierung von Dokumenten mehr als ausreichend. Wenn du keine Cloud-API hast, funktioniert es auch lokal über Ollama, du brauchst nur ausreichend Hardware. Die gesamte Einrichtung ist in einem separaten Artikel beschrieben.

KI mit Paperless verbinden?

Ich habe eine vollständige Anleitung vorbereitet — Open WebUI, Python Bridge, Verbindung mit Claude Haiku oder lokalem Ollama-Modell. Schritt für Schritt von der Installation bis zur ersten intelligenten Suche.

Paperless-AI — Anleitung →

Für wen ist Paperless-ngx?

Selbstständige

Rechnungen, Steuerdokumente, Verträge — alles in Ordnung und jederzeit auffindbar.

Familien

Garantiescheine, Versicherungen, Immobiliendokumente — keine Schachtel im Schrank mehr.

IT-Enthusiasten

Volle Datenkontrolle, self-hosted, REST API, Integration mit allem.

Home Office

Zentralisierte Dokumentenverwaltung ohne Cloud-Abonnements.

Mobile Nutzer

Beleg vor Ort fotografieren, das System übernimmt die Kategorisierung.

Privacy-first

Keine Cloud von Drittanbietern. Dokumente bleiben ausschließlich bei dir.

Was ich nach zwei Jahren festgestellt habe

Paperless-ngx ist nicht nur ein digitales Archiv. Es ist ein System, das sich verbessert, je mehr du es verwendest — je mehr Dokumente es hat, desto besser schlägt es Kategorien und Korrespondenten vor. Mit KI-Integration ist es nicht mehr nur ums Speichern gegangen — ich habe angefangen, den Inhalt meiner Dokumente aktiv abzufragen.

Heute dauert es weniger als 10 Sekunden, um ein beliebiges Dokument zu finden. Die Schachtel mit Garantiescheinen steht noch im Schrank, aber zum letzten Mal habe ich vor mehr als einem Jahr hineingegriffen.

⚠️ Datensicherung

Paperless-ngx ist eine self-hosted Lösung — du bist für Backups verantwortlich. Ich empfehle dringend, automatische Backups der Datenbank und des Dokumentenverzeichnisses einzurichten, idealerweise auf einem externen Medium oder offsite.

Paperless-ngx installieren?

Ich habe eine vollständige Installationsanleitung vorbereitet — Docker Stack für Synology NAS, Linux und Windows, mit MariaDB-Datenbank, OCR-Einrichtung und erstem Start.

Paperless-ngx — Installationsanleitung →

Like everyone, I had documents scattered everywhere. Some lived in Gmail, some on Google Drive, physical invoices in a box somewhere in a cabinet, photos of receipts on my phone. And whenever I needed to find something — a warranty card or an old invoice — it always took longer than it should. I started looking for a solution and came across Paperless-ngx.

The first time I tried it was about two years ago. I have to be honest — back then it wasn't as straightforward. The interface was less polished and setting things up required more patience. Today it's a different league. And on top of that — AI came along and changed the game.

How to get documents in

This was my first question: how do I move years of accumulated documents into one system without losing track? It turned out Paperless-ngx has multiple ways to do this simultaneously.

Gmail / Email

Automatic attachment download via IMAP

→

Web / Drag & Drop

Directly in the browser

→

Mobile App

Take a photo and send on the spot

→

Paperless OCR

Automatic analysis and text recognition

Connecting with Gmail works via a Google App Password — your regular password won't work here, since Gmail requires a special app password for IMAP access. Set it up once in your Google account and Paperless will automatically download attachments according to your rules. New invoice via email? Paperless downloads it, analyses it and files it — without your intervention.

I handle physical documents through the mobile app. Take a photo and send it — OCR takes care of the rest. PDF, Word, Excel, images — Paperless recognises everything.

What is OCR?

Optical Character Recognition — technology that turns an image or scan into searchable text. This lets you search in Paperless even inside scanned documents, not just native PDFs.

Categories and tags — order that works

Once documents are in the system, they need to be organised. Paperless uses a combination of correspondents (who sent the document), document types (invoice, contract, warranty…) and tags. Together they form a system you can navigate very quickly.

When I started, I spent weeks manually going through old documents and assigning categories by hand. It worked, but it was tedious. Today I'd do it in a few hours — thanks to AI.

AI + Paperless: the next level

This is where Paperless-ngx transforms from a good tool into an exceptional one. Through Open WebUI you can connect a local or cloud language model directly to your document library.

It works via a simple Python script — paperless-bridge — which exposes the Paperless API to the LLM. The model can then automatically suggest categories, tags and correspondents for new documents, or simply answer questions like: "When does my washing machine warranty expire?" or "How much did I spend on electricity last year?"

I use Claude Haiku via API — fast, affordable and more than capable for document categorisation. If you don't have a cloud API, it also works locally via Ollama, you just need sufficient hardware. The full setup is described in a dedicated article.

Want to connect AI to Paperless?

I've prepared a complete guide — Open WebUI, Python bridge, connecting Claude Haiku or a local Ollama model. Step by step from installation to your first intelligent search.

Paperless-AI — guide →

Who is Paperless-ngx for?

Freelancers

Invoices, tax documents, contracts — all organised and findable at any time.

Families

Warranty cards, insurance, property documents — no more box in the cupboard.

IT enthusiasts

Full data control, self-hosted, REST API, integrates with anything.

Home office

Centralised document management without cloud subscription fees.

Mobile users

Photograph a receipt on the spot, the system handles categorisation.

Privacy-first

No third-party cloud. Documents stay exclusively with you.

What I found after two years

Paperless-ngx is not just a digital archive. It's a system that improves as you use it — the more documents it has, the better it suggests categories and correspondents. With AI integration it stopped being just about storage — I started actively querying the content of my documents.

Today it takes me less than 10 seconds to find any document. The box of warranty cards still sits in the cupboard, but the last time I reached into it was over a year ago.

⚠️ Backups

Paperless-ngx is a self-hosted solution — you are responsible for backups. I strongly recommend setting up automated backups of both the database and the document folder, ideally to external media or offsite.

Ready to install Paperless-ngx?

I've prepared a complete installation guide — Docker stack for Synology NAS, Linux and Windows, with MariaDB database, OCR configuration and first launch.

Paperless-ngx — installation guide →

Paperless-ngx: Koniec chaosu s dokumentmi

Ako dostať dokumenty dnu

Kategorizácia a tagy — poriadok, ktorý funguje

AI + Paperless: ďalší level

Pre koho je Paperless-ngx?

Čo som zistil po dvoch rokoch

Paperless-ngx: Schluss mit dem Dokumentenchaos

Wie man Dokumente ins System bekommt

Kategorisierung und Tags — Ordnung, die funktioniert

KI + Paperless: das nächste Level

Für wen ist Paperless-ngx?

Was ich nach zwei Jahren festgestellt habe

Paperless-ngx: End of Document Chaos

How to get documents in

Categories and tags — order that works

AI + Paperless: the next level

Who is Paperless-ngx for?

What I found after two years