[[Uebersicht|← Zurück zur Homepage]] # Projekt: PaperSafe ## Übersicht Aufbau eines dedizierten Dokumenten-Archivservers auf dem bestehenden Proxmox-Host mit **Paperless-ngx**. Ziel ist die zentrale, durchsuchbare und langfristig gesicherte Archivierung aller Dokumente – Papierbelege werden gescannt, digitale Dokumente direkt eingespielt. **Rolle:** Eigenbetrieb (Planung, Installation, Betrieb) **Plattform:** Proxmox VE, 192.168.2.146 (Port 8006) **Produkt:** Paperless-ngx (Open Source, AGPL-3.0) ## Zieldefinition 1. Zentrale Ablage aller Dokumente mit Volltextsuche (OCR, deutschsprachig) 2. Automatische Erfassung: Scanner-Ordner (Consume), ggf. E-Mail-Abruf 3. Strukturierung über Korrespondenten, Dokumenttypen, Tags, Speicherpfade 4. Verlässliches, getestetes Backup- und Restore-Konzept 5. Rein private Nutzung – geschäftliche Belege bleiben außen vor 6. Nachvollziehbare Doku für Installation, Konfiguration und Betrieb ## Getroffene Entscheidungen (18.07.2026) | Thema | Entscheidung | |---|---| | **Deployment** | **Variante A: unprivilegierter LXC + Docker Compose** (offizieller Installationsweg, ressourcenschonend) | | **Nutzungsumfang** | **Rein privat.** Keine geschäftlichen Obeco-Belege in diesem System – damit gelten **keine GoBD-Anforderungen**, keine Verfahrensdokumentation nötig | | **Backup-Ziel** | **Synology NAS `dsobe2023`** – bereits aktives Proxmox-Backup-Ziel, Sicherung außerhalb des Hosts | ## Offene Entscheidungen - [ ] Scanner-Anbindung: welches Gerät, Übergabeweg in den Consume-Ordner (SMB/Scan-to-Folder) - [ ] Erreichbarkeit: nur LAN oder externer Zugriff (VPN/Reverse Proxy) - [ ] Umgang mit den Papieroriginalen nach dem Scan (aufbewahren / vernichten) ## Rahmenbedingungen (Stand: 18.07.2026) | Feld | Status | |---|---| | **Host** | Bestehender Proxmox VE Server 192.168.2.146 | | **Storage** | Produktivdaten auf Proxmox-Storage lokal; **Backup auf Synology NAS `dsobe2023`** (bestehende Sicherungsinfrastruktur) | | **Deployment** | Unprivilegierter LXC + Docker Compose (Variante A, entschieden 18.07.2026) | | **Nutzungsumfang** | Rein privat – keine GoBD-Relevanz | | **Sprache OCR** | Deutsch (zusätzlich Englisch sinnvoll) | | **Netzwerk** | Zunächst LAN-intern angenommen | ## Struktur der Dokumentation | Note | Inhalt | |---|---| | **00-Start** | Diese Übersicht, Ziele, offene Entscheidungen (dieses Dokument) | | **01-Konzept-Architektur** | Deployment-Varianten im Vergleich, Storage, Netzwerk, Diskussion privat/geschäftlich (GoBD) | | **02-Installation** | Schritt-für-Schritt Installation auf dem Proxmox | | **03-Konfiguration** | Erstkonfiguration, OCR, Tags/Korrespondenten, Benutzer, Scanner-Anbindung | | **04-Betrieb-Backup** | Backup/Restore, Updates, Monitoring, Wiederanlauf | | **05-Vorgabe-ClaudeCode** | Arbeitsanweisung für die Umsetzung durch Claude Code mit Proxmox-Zugriff: Grundregeln, Phasen, Freigabe-Gates. **Soll-Seite, wird während der Umsetzung nicht verändert** | | **06-Umsetzungsprotokoll** | Ist-Seite: chronologisches Protokoll der Umsetzung, wird von Claude Code nach jeder Phase fortgeschrieben | | **07-Automatischer-Import** | **Ist:** die gebaute Zuleitung vom Windows-Explorer bis in Paperless. Freigabe, Mount, Variablen, gelöste Fallstricke | | **08-Feinkonzept-Regelwerk** | **Soll für den Dateiimport:** Regelwerk für Korrespondenten, Tags, Speicherpfade und Workflows. Matching vs. Workflows, Verarbeitungsreihenfolge, Vorgehen in Schritten | | **09-E-Mail-Import** | Eigenes Arbeitspaket, **zurückgestellt** bis der Dateiimport steht. Konten, Regeln, Auffangregel, Mail-Aktionen | | **CLAUDE.md** | Projektregeln, die Claude Code beim Arbeiten in diesem Ordner automatisch geladen bekommt (Kurzfassung der Grundregeln aus 05) | ## Stand der Umsetzung (18.07.2026) **Das System ist in Betrieb und produktionsbereit.** Alle sieben Phasen sind abgeschlossen, der Restore-Test war erfolgreich. | Wert | Ergebnis | |---|---| | Container | CT 110 `papersafe`, läuft | | Erreichbar unter | `http://192.168.2.35:8000` | | Version | Paperless-ngx 2.20.15 | | Backup | 3× täglich `vzdump` aufs NAS + wöchentlicher logischer Export | | Restore-Test | 18.07.2026 bestanden | | Dokumenteneingang | Freigabe `\\dsobe2023\papersafeconsume`, Ordnernamen werden automatisch zu Tags | | Dokumentenbestand | 0 – noch keine echten Dokumente eingespielt | ## Nächste Schritte **Reihenfolge: erst Dateiimport ([[08-Feinkonzept-Regelwerk]]), danach E-Mail ([[09-E-Mail-Import]]).** Die offenen Punkte stehen jeweils in diesen Notizen. 1. **Ordnerliste der beiden Quellbäume** `Privat` und `Obeco` liefern (`dir /b`) – Rohdatenbasis für Korrespondenten und Pfad-Workflows 2. Korrespondenten und Workflow „Pfad → Korrespondent" anlegen 3. **Testlauf mit 20–30 realen Dokumenten**, **mit Kopien** – Paperless verschiebt die Dateien --- **Status:** **In Betrieb** – Installation, Konfiguration und Backup abgeschlossen, Restore-Test bestanden **Version:** 1.9 **Letzte Aktualisierung:** 19.07.2026 ### Änderungshistorie | Version | Datum | Uhrzeit | Änderung | |---|---|---|---| | 1.0 | 18.07.2026 | 13:44 | Erstfassung – Projektstart PaperSafe, Zieldefinition, offene Entscheidungen, Dokumentationsstruktur | | 1.1 | 18.07.2026 | 13:52 | **Nutzerentscheidungen:** Deployment = LXC + Docker Compose (Variante A), Nutzung = rein privat (GoBD entfällt), Backup-Ziel = NAS `dsobe2023`. Rahmenbedingungen, Ziele und nächste Schritte entsprechend angepasst | | 1.2 | 18.07.2026 | 14:05 | Note [[05-Vorgabe-ClaudeCode]] erstellt (Arbeitsanweisung für die Umsetzung durch Claude Code mit Proxmox-Zugriff) und in Strukturtabelle ergänzt; nächste Schritte auf das Phasenmodell mit Freigabe-Gates umgestellt | | 1.3 | 18.07.2026 | 14:12 | **Nutzerangabe:** `dsobe2023` als Synology-NAS und bereits bestehendes Proxmox-Backup-Ziel präzisiert – Backup nutzt vorhandene Infrastruktur statt Neueinrichtung | | 1.4 | 18.07.2026 | 14:30 | Note [[06-Umsetzungsprotokoll]] erstellt und in Strukturtabelle ergänzt – Trennung von Soll (05) und Ist (06), da Claude Code Vault-Zugriff hat und selbst dokumentiert | | 1.5 | 18.07.2026 | 14:45 | `CLAUDE.md` im Projektordner angelegt – lädt die Projektregeln automatisch, sobald Claude Code in diesem Ordner arbeitet; in Strukturtabelle ergänzt | | 1.6 | 18.07.2026 | 17:40 | **Umsetzung abgeschlossen** (Phase 7): Status auf „In Betrieb", Stand der Umsetzung mit Systemdaten ergänzt, nächste Schritte auf den Produktivbetrieb ausgerichtet (Tag-Schema, Alltagskonto, Scanner, erste echte Dokumente) | | 1.7 | 18.07.2026 | 18:45 | **Automatischer Ordner-Import eingerichtet** (Phase 8): Dokumenteneingang über die neue NAS-Freigabe `papersafeconsume` in die Systemdaten aufgenommen, nächste Schritte auf Testlauf und Gesamtbestand umgestellt. Details in [[07-Automatischer-Import]] und [[06-Umsetzungsprotokoll]] | | 1.8 | 19.07.2026 | – | **Feinkonzept [[08-Feinkonzept-Regelwerk]] angelegt** und in die Strukturtabelle aufgenommen. Rollen der Notizen 07 und 08 geschärft (07 = Ist der Zuleitung, 08 = Soll des Regelwerks). **Offene Punkte zentral in 08 gebündelt** statt über die Notizen verstreut; nächste Schritte entsprechend gekürzt. Dokumenttypen entfallen (Nutzerentscheidung nach Begriffsklärung) | | 1.9 | 19.07.2026 | – | **[[09-E-Mail-Import]] als eigenes Arbeitspaket angelegt** und in die Strukturtabelle aufgenommen (Nutzerentscheidung: erst Dateiimport, dann Mail). 08 auf den Dateiimport zugespitzt. Quellordner konkretisiert: `Privat` und `Obeco`, GoBD-Frage geprüft und als nicht einschlägig entschieden | --- [[Impressum|Impressum]] | [[Datenschutzerklärung|Datenschutz]]