Du liebst Paperless-ngx, aber es ist Zeit für eine Neuinstallation? Vielleicht möchtest du auf einen neuen Server umziehen, auf eine modernere Version aktualisieren oder einfach nur eine saubere Installation durchführen. Die gute Nachricht ist: Du musst deine wertvollen Dokumente und Metadaten nicht verlieren! Dieser umfassende Leitfaden zeigt dir Schritt für Schritt, wie du Paperless-ngx neu installierst und deine alten Daten sicher migrierst.
Warum eine Neuinstallation von Paperless-ngx?
Es gibt viele Gründe, warum eine Neuinstallation von Paperless-ngx sinnvoll sein kann:
- Performance-Verbesserungen: Eine frische Installation kann Performance-Probleme beheben, die durch veraltete Konfigurationen oder Fragmentierung der Datenbank entstanden sind.
- Versions-Upgrade: Manchmal ist eine Neuinstallation der sauberste Weg, um auf eine neue Hauptversion zu aktualisieren.
- Serverumzug: Beim Umzug auf einen neuen Server ist eine Neuinstallation oft einfacher und schneller als der Versuch, eine bestehende Installation zu migrieren.
- Behebung von Fehlern: Eine Neuinstallation kann hartnäckige Fehler beheben, die sich nicht anders lösen lassen.
- Vereinfachung der Konfiguration: Eine Neuinstallation ermöglicht es dir, von Grund auf neu zu beginnen und die Konfiguration nach deinen Bedürfnissen anzupassen.
Vorbereitung ist alles: Datensicherung und Planung
Bevor du mit der Neuinstallation beginnst, ist eine sorgfältige Vorbereitung unerlässlich. Der wichtigste Schritt ist die Datensicherung. Du solltest sowohl die Datenbank als auch die gespeicherten Dokumente sichern.
1. Datenbank-Backup
Paperless-ngx verwendet in der Regel eine PostgreSQL-Datenbank. Um ein Backup zu erstellen, kannst du das Tool pg_dump verwenden. Verbinde dich mit deinem Server und führe den folgenden Befehl aus (passe die Parameter an deine Umgebung an):
pg_dump -U dein_benutzer -d deine_datenbank -f paperless_backup.sqlErsetze dein_benutzer mit dem Benutzernamen für den Datenbankzugriff und deine_datenbank mit dem Namen deiner Paperless-ngx Datenbank. paperless_backup.sql ist der Name der Backup-Datei. Bewahre diese Datei an einem sicheren Ort auf!
2. Dokumenten-Backup
Die Dokumente, die Paperless-ngx verwaltet, werden in einem separaten Ordner gespeichert. Dieser Ordner wird in der docker-compose.yml Datei definiert, typischerweise unter dem Volume data oder ähnlich. Kopiere den gesamten Inhalt dieses Ordners an einen sicheren Ort.
Wichtig: Stelle sicher, dass du genügend Speicherplatz für das Backup hast!
3. Konfigurationsdateien sichern
Es ist ratsam, auch deine Konfigurationsdateien (insbesondere die docker-compose.yml und die .env Datei) zu sichern. Diese enthalten wichtige Informationen über deine Konfiguration, die du später wiederverwenden kannst.
4. Planung der Neuinstallation
Überlege dir, wie du die Neuinstallation durchführen möchtest. Möchtest du die gleiche Infrastruktur verwenden, oder möchtest du auf einen neuen Server oder eine andere Deployment-Methode umsteigen (z.B. von Docker Compose zu Kubernetes)? Plane die notwendigen Schritte und Ressourcen im Voraus.
Die Neuinstallation von Paperless-ngx
Nachdem du deine Daten gesichert hast, kannst du mit der Neuinstallation von Paperless-ngx beginnen. Befolge die offizielle Dokumentation für die Installation. Hier sind die grundlegenden Schritte:
- Installiere Docker und Docker Compose: Stelle sicher, dass Docker und Docker Compose auf deinem System installiert sind.
- Lade die
docker-compose.ymlDatei herunter: Lade die aktuelledocker-compose.ymlDatei von der offiziellen Paperless-ngx Website oder von deinem vorherigen Backup herunter. - Konfiguriere die
.envDatei: Passe die.envDatei an deine Bedürfnisse an. Achte besonders auf die Datenbankeinstellungen und die Pfade zu den Volumes. - Starte die Container: Führe den Befehl
docker-compose up -daus, um die Container zu starten.
Datenmigration: Die Wiederherstellung deiner Dokumente
Jetzt kommt der wichtigste Teil: die Datenmigration. Du musst die Datenbank und die Dokumente aus deinen Backups in die neue Installation wiederherstellen.
1. Datenbank-Wiederherstellung
Verbinde dich mit der neuen Datenbankinstanz und stelle das Backup wieder her. Verwende dazu das Tool psql:
psql -U dein_benutzer -d deine_datenbank -f paperless_backup.sqlErsetze auch hier dein_benutzer und deine_datenbank mit den entsprechenden Werten. Gib das Passwort ein, wenn du dazu aufgefordert wirst.
2. Dokumenten-Wiederherstellung
Kopiere die gesicherten Dokumente in den entsprechenden Ordner, der in der docker-compose.yml Datei definiert ist (typischerweise unter dem Volume data oder ähnlich). Stelle sicher, dass die Dateiberechtigungen korrekt sind, damit Paperless-ngx auf die Dokumente zugreifen kann.
Wichtig: Nach der Wiederherstellung der Datenbank und der Dokumente musst du den Paperless-ngx Verbraucher (Consumer) neu starten, damit er die neuen Dokumente indiziert und verarbeitet.
docker-compose restart consumerFehlerbehebung und Tipps
Bei der Datenmigration können verschiedene Probleme auftreten. Hier sind einige Tipps zur Fehlerbehebung:
- Berechtigungsprobleme: Stelle sicher, dass die Dateiberechtigungen für die Dokumente und die Datenbank korrekt sind.
- Datenbankverbindungsfehler: Überprüfe die Datenbankeinstellungen in der
.envDatei und stelle sicher, dass die Datenbank erreichbar ist. - Consumer-Fehler: Überprüfe die Logs des Consumers auf Fehler. Möglicherweise müssen Bibliotheken neu installiert oder aktualisiert werden.
- Inkompatibilitäten: Wenn du von einer älteren Version auf eine neuere Version migrierst, kann es zu Inkompatibilitäten geben. Lies die Release Notes der neuen Version sorgfältig durch und passe deine Konfiguration gegebenenfalls an.
Automatisierung der Datenmigration
Für größere Installationen oder bei häufigen Neuinstallationen kann es sinnvoll sein, die Datenmigration zu automatisieren. Du kannst Skripte verwenden, um die Datenbank zu sichern und wiederherzustellen, die Dokumente zu kopieren und die Container neu zu starten. Tools wie Ansible oder Terraform können helfen, den Prozess zu orchestrieren.
Fazit
Die Neuinstallation von Paperless-ngx und die Migration deiner Daten ist mit sorgfältiger Planung und Vorbereitung gut machbar. Indem du deine Daten sicherst, die Neuinstallation sorgfältig durchführst und die Schritte zur Datenwiederherstellung befolgst, kannst du deine wertvollen Dokumente bewahren und von den Vorteilen einer frischen Installation profitieren. Viel Erfolg!