Wenn eine Paperless-ngx-App eines Drittanbieters fehlschlägt, weil ihre Compose-Datei auf ein fehlerhaftes Tika-Image verweist, korrigieren Sie die App-Definition oder verwenden Sie ein gepflegtes Paket, anstatt dasselbe defekte Compose wiederholt neu zu installieren. Im ursprünglichen Thread verwies das Coolstore-Paket auf ein Tika-Image, das der Benutzer für falsch hielt, während ein BigBear-Paket nach mehreren Versuchen schließlich erfolgreich installiert wurde.
Der Thread klärte nie, warum die früheren BigBear-Versuche fehlschlugen. Daher wäre es ungenau zu behaupten, dass ausschließlich eine Änderung des IP-Abschnitts eine universelle Lösung darstellt. Der nachhaltige Ansatz besteht darin, das Compose eines Drittanbieters mit den aktuellen Anforderungen von Paperless-ngx aus dem Upstream zu vergleichen.
Tika ist ein optionaler Paperless-Dienst
Die aktuelle Konfigurationsreferenz von Paperless-ngx erklärt, dass Tika und Gotenberg optionale Dienste für Office-Dokumente und die E-Mail-Analyse sind. Wenn diese Integration aktiviert ist, muss Paperless mit erreichbaren Endpunkten konfiguriert werden.
Das bedeutet, dass ein fehlerhaftes Tika-Service-Image eine Installation beeinträchtigen kann, die diese Integration aktiviert, selbst wenn die Definition des zentralen Paperless-Containers ansonsten gültig ist.
Coolstore und BigBear als Pakete von Drittanbietern behandeln
Eine Antwort aus der Community wies richtigerweise darauf hin, dass Coolstore eine App-Quelle eines Drittanbieters ist. Ein fehlerhafter Image-Verweis in diesem Paket sollte dem Maintainer gemeldet werden, anstatt als grundlegender Fehler von ZimaOS interpretiert zu werden.
Wenn ein Store-Paket veraltet ist, vergleichen Sie es mit den aktuellen Paperless-Docker-Beispielen aus dem Upstream oder mit einem anderen gepflegten Paket. Sichern Sie Ihre vorhandenen Datenpfade, bevor Sie Stacks ändern.
Compose sorgfältig bearbeiten oder erneut importieren
Das aktuelle ZimaOS kann benutzerdefinierte Docker-Compose-Definitionen importieren. Die Anleitung zur Fehlerbehebung bei benutzerdefinierten Compose-Dateien ist der sicherere Weg, wenn eine App-Store-Definition ein fehlerhaftes Image oder ein nicht unterstütztes Feld enthält.
ZimaOS 1.7.1 führt in den aktuellen Versionshinweisen außerdem eine verbesserte Kompatibilität beim Speichern von YAML-Dateien auf. Diese Verbesserung repariert jedoch nicht automatisch einen fehlerhaften Image-Verweis in einem Repository eines Drittanbieters.
Bevor Sie Paperless erneut installieren
- Sichern Sie die Speicherorte der Paperless-Daten, Medien und Datenbank.
- Stellen Sie sicher, dass jeder Image-Verweis vorhanden und gepflegt ist.
- Betreiben Sie Paperless, die Datenbank, Redis, Tika und Gotenberg in den vorgesehenen Compose-Netzwerken.
- Ändern Sie jeweils nur eine Fehlerquelle, damit die erfolgreiche Lösung eindeutig erkennbar bleibt.
Wenn eine Installation nach mehreren Wiederholungsversuchen plötzlich erfolgreich ist, wie es im Thread der Fall war, erfinden Sie keine Ursache. Kennzeichnen Sie das Ergebnis weiterhin als vom Benutzer bestätigten Erfolg bei ungeklärtem ursprünglichem Fehler.
