Files
homelab/docs/anleitungen/paperless.md
T
x3 4a55944aa8 Homelab-Dokumentation und Konfigurationsvorlagen
Dokumentation aus dem Wiki uebernommen und um die Dienste auf dem Server
erweitert. Alle Anleitungen sind so geschrieben, dass sich der jeweilige
Dienst allein daraus neu aufsetzen laesst.

docs/      Dienste im Heimnetz (aus dem Wiki, anonymisiert)
services/  Dienste auf dem Server mit Konfigurationsvorlagen
           - matrix-synapse: Homeserver, Postgres, Well-Known-Delegation
           - coturn:         TURN-Relay fuer Anrufe
           - element-web:    Web-Client
           - wikijs, gitea, nginx

Durchgehend anonymisiert: echte Domain durch example.com ersetzt, IP-Adressen
und E-Mail-Adressen durch Platzhalter. Konfigurationsdateien liegen nur als
.example mit Platzhaltern statt echter Secrets vor.

Die Anleitungen halten die Stolpersteine fest, die beim Aufbau tatsaechlich
aufgetreten sind, unter anderem:
- Synapse verlangt LC_COLLATE=C, sonst startet es nicht
- server_name ist nachtraeglich nicht aenderbar -> Delegation noetig
- register_new_matrix_user liest conf.d nicht, Secret muss per -k kommen
- coturn braucht external-ip, sonst kommen keine Medien durch
- Gruppenmitgliedschaft fuer den Zertifikatszugriff wirkt erst beim Neustart
- nginx vererbt add_header nicht in location-Bloecke mit eigenen Direktiven
2026-08-31 17:56:02 +00:00

1.9 KiB

Paperless - Anleitung

Mit Paperless organisierst du Dokumente digital, inklusive automatischer Texterkennung. So richtest du es ein und nutzt es im Alltag.

Aufsetzen unter Portainer

  1. Lege in Portainer einen Stack mit dem Namen paperless an.
  2. Füge den Paperless-Container hinzu. Er benötigt einen Ordner für eingehende Dokumente (Consume) und einen für die archivierten Dateien, damit die Ablage sauber getrennt ist.
  3. Wichtig: Richte eine Datenbank ein (z.B. PostgreSQL), in der Paperless die Metadaten speichert. Die eigentlichen Dokumente liegen in den Datei-Ordnern.
  4. Starte den Stack und öffne die Weboberfläche, um dich mit dem Admin-Account anzumelden.

Dokumente einwerfen

  1. Lege ein Dokument (PDF, Scan) in den Eingangsordner (Consume-Ordner).
  2. Paperless erkennt den Text automatisch (OCR) und sortiert das Dokument in die Ablage ein.
  3. Nach kurzer Zeit ist das Dokument in der Oberfläche verfügbar und durchsuchbar.

Dokumente organisieren

  • Tags vergeben: Vergib Tags wie "Rechnung", "Vertrag" oder "Kontoauszug", damit du klar filtern kannst.
  • Korrespondenten: Ordne Dokumente einem Absender zu (z.B. deinem Stromanbieter).
  • Suchen: Die Volltextsuche findet Dokumente auch nach Textstellen im Inneren.

Berechtigungen und Zugriff

Bei Paperless lassen sich Benutzer und Gruppen einrichten. So können mehrere Personen zugreifen, ohne dass alle Dokumente offen sind:

  • Lege Benutzer an und weise ihnen die passenden Rechte zu.
  • Dokumente können mit Sicht- und Bearbeitungsrechten versehen werden.

Für "nur zur Sicht" kannst du Benutzer so anlegen, dass sie Dokumente nur lesen, aber nicht verändern oder löschen können.

Wartung

  • Achte darauf, dass regelmäßig Backups der Datenbank und der Dokumenten-Ordner gemacht werden - Dokumente sind schließlich wertvoll.
  • Leere den Eingangsordner nach der Verarbeitung, damit nichts doppelt oder gar nicht verarbeitet wird.