Paperless-ngx ist eine fantastische Open-Source-Lösung zur Dokumentenverwaltung, die Ihnen hilft, den Papierkram zu reduzieren und Ihre Dokumente effizient zu organisieren. Aber was passiert, wenn Ihre Installation fehlerhaft ist, Sie auf eine neue Hardware umziehen oder einfach nur eine saubere Neuinstallation bevorzugen? Keine Sorge! In diesem umfassenden Leitfaden zeigen wir Ihnen, wie Sie Paperless-ngx neu installieren und alle Ihre wertvollen alten Daten behalten können.
Warum Paperless-ngx neu installieren?
Es gibt verschiedene Gründe, warum Sie Paperless-ngx neu installieren möchten:
- Beschädigte Installation: Fehlerhafte Updates, Systemabstürze oder andere Probleme können Ihre Paperless-ngx-Installation beschädigen.
- Migration auf neue Hardware: Beim Umzug auf einen neuen Server oder ein neues NAS ist eine Neuinstallation oft die sauberste Lösung.
- Upgrade des Betriebssystems: Ein Upgrade des Betriebssystems kann zu Inkompatibilitäten mit der bestehenden Paperless-ngx-Installation führen.
- Performance-Probleme: Manchmal kann eine Neuinstallation helfen, Performance-Probleme zu beheben, die sich im Laufe der Zeit angesammelt haben.
- Vereinfachung der Konfiguration: Eine Neuinstallation kann Ihnen die Möglichkeit geben, Ihre Konfiguration von Grund auf neu zu gestalten und zu vereinfachen.
Wichtiger Hinweis: Datensicherung ist entscheidend!
Bevor Sie mit der Neuinstallation beginnen, ist eine umfassende Datensicherung absolut unerlässlich. Dies stellt sicher, dass Sie Ihre Daten im Falle eines Fehlers wiederherstellen können. Wir werden uns im nächsten Abschnitt genauer mit der Sicherung befassen.
Schritt 1: Vollständige Datensicherung von Paperless-ngx
Die Sicherung Ihrer Paperless-ngx-Daten umfasst im Wesentlichen drei Bereiche:
- Die Datenbank: Hier werden alle Metadaten Ihrer Dokumente (Titel, Tags, Korrespondenten usw.) gespeichert.
- Die Medien-Dateien: Dies sind Ihre gescannten Dokumente selbst, die sich in der Regel im
/data-Verzeichnis (oder dem von Ihnen konfigurierten Speicherort) befinden. - Die Konfigurationsdateien: Diese Dateien enthalten Ihre Paperless-ngx-Einstellungen und -Konfigurationen.
1.1 Sichern der Datenbank
Die Vorgehensweise zur Sicherung der Datenbank hängt davon ab, welches Datenbank-System Sie verwenden (z.B. PostgreSQL, MySQL). Wir gehen hier exemplarisch von PostgreSQL aus, da dies die empfohlene und häufigste Datenbank für Paperless-ngx ist. Sie können ein Tool wie pg_dump verwenden:
pg_dump -U dein_benutzername -W -F c paperless_ngx > paperless_ngx_backup.dumpErsetzen Sie dein_benutzername durch den Benutzernamen, der Zugriff auf die Paperless-ngx-Datenbank hat, und paperless_ngx durch den Namen Ihrer Datenbank. Das -W Flag fordert Sie zur Eingabe des Passworts auf. Das -F c Flag erstellt ein komprimiertes Archiv. Speichern Sie die Datei paperless_ngx_backup.dump an einem sicheren Ort.
1.2 Sichern der Medien-Dateien
Die einfachste Möglichkeit, die Medien-Dateien zu sichern, ist die Verwendung von rsync oder einem ähnlichen Tool zum Kopieren des gesamten /data-Verzeichnisses:
rsync -av /opt/paperless/data/ /pfad/zum/backup-verzeichnis/Ersetzen Sie /opt/paperless/data/ durch den tatsächlichen Pfad zu Ihrem data-Verzeichnis und /pfad/zum/backup-verzeichnis/ durch den Pfad, an dem Sie die Sicherung speichern möchten. rsync kopiert nur geänderte Dateien, was die Sicherung schnell und effizient macht.
1.3 Sichern der Konfigurationsdateien
Die Konfigurationsdateien befinden sich in der Regel im /opt/paperless/docker-compose.yml (oder dem entsprechenden Pfad, in dem Sie Paperless-ngx installiert haben). Sichern Sie diese Datei ebenfalls:
cp /opt/paperless/docker-compose.yml /pfad/zum/backup-verzeichnis/docker-compose.yml.bakSichern Sie auch alle anderen Konfigurationsdateien, die Sie manuell geändert haben, z.B. .env-Dateien.
Schritt 2: Paperless-ngx deinstallieren
Bevor Sie Paperless-ngx neu installieren, müssen Sie die bestehende Installation entfernen. Wenn Sie Docker Compose verwenden, ist dies relativ einfach:
- Navigieren Sie zum Verzeichnis, in dem sich Ihre
docker-compose.yml-Datei befindet. - Führen Sie den Befehl
docker-compose downaus:docker-compose downDieser Befehl stoppt und entfernt alle Container, die mit Paperless-ngx verbunden sind.
Entfernen Sie optional das /opt/paperless Verzeichnis, falls Sie eine wirklich saubere Neuinstallation wünschen. Achtung: Stellen Sie sicher, dass Sie vorher die Sicherung durchgeführt haben, da dieser Schritt alle verbleibenden Daten löscht.
Schritt 3: Paperless-ngx neu installieren
Die Neuinstallation von Paperless-ngx erfolgt in der Regel gemäß der offiziellen Dokumentation. Hier ist eine kurze Zusammenfassung der Schritte, basierend auf der Verwendung von Docker Compose:
- Installieren Sie Docker und Docker Compose: Stellen Sie sicher, dass Docker und Docker Compose auf Ihrem System installiert sind. Die Anweisungen finden Sie auf der Docker-Website.
- Laden Sie die
docker-compose.yml-Datei herunter oder erstellen Sie sie: Sie können die aktuelledocker-compose.yml-Datei von der Paperless-ngx-Website herunterladen oder Ihre gesicherte Version (angepasst) verwenden. - Konfigurieren Sie die
docker-compose.yml-Datei: Passen Sie diedocker-compose.yml-Datei an Ihre Bedürfnisse an, z.B. Datenbank-Einstellungen, Ports, Benutzername, Passwort usw. - Starten Sie Paperless-ngx: Führen Sie den Befehl
docker-compose up -daus, um Paperless-ngx im Hintergrund zu starten:docker-compose up -d
Schritt 4: Datenwiederherstellung
Jetzt kommt der wichtigste Teil: die Wiederherstellung Ihrer gesicherten Daten.
4.1 Datenbank wiederherstellen
Verwenden Sie pg_restore, um Ihre Datenbank wiederherzustellen:
pg_restore -U dein_benutzername -d paperless_ngx -W paperless_ngx_backup.dumpErsetzen Sie dein_benutzername, paperless_ngx und paperless_ngx_backup.dump durch die entsprechenden Werte. Sie werden aufgefordert, das Passwort einzugeben.
4.2 Medien-Dateien wiederherstellen
Kopieren Sie die gesicherten Medien-Dateien zurück in das /data-Verzeichnis:
rsync -av /pfad/zum/backup-verzeichnis/data/ /opt/paperless/data/Stellen Sie sicher, dass die Pfade korrekt sind.
4.3 Berechtigungen überprüfen
Nach dem Wiederherstellen der Daten ist es wichtig, die Dateiberechtigungen zu überprüfen. Paperless-ngx benötigt Zugriff auf die wiederhergestellten Dateien. Stellen Sie sicher, dass der Benutzer, unter dem Paperless-ngx läuft, die entsprechenden Berechtigungen hat. Dies kann je nach Ihrer Konfiguration variieren. In der Regel sind es der User mit der ID 1000:1000.
Schritt 5: Paperless-ngx testen
Nach der Wiederherstellung aller Daten ist es wichtig, Paperless-ngx zu testen. Überprüfen Sie, ob alle Ihre Dokumente vorhanden sind, die Metadaten korrekt angezeigt werden und Sie neue Dokumente hochladen und verarbeiten können.
Fazit
Die Neuinstallation von Paperless-ngx unter Beibehaltung Ihrer Daten mag zunächst einschüchternd wirken, ist aber mit sorgfältiger Planung und den richtigen Schritten gut machbar. Die Datensicherung ist das A und O. Folgen Sie dieser Anleitung Schritt für Schritt, und Sie sollten Ihre Paperless-ngx-Installation in kürzester Zeit wiederhergestellt haben. Vergessen Sie nicht, regelmäßig Backups zu erstellen, um sich vor Datenverlust zu schützen!