Als een Paperless-ngx-app van derden niet werkt omdat het Compose-bestand naar een verkeerde Tika-image verwijst, pas dan de app-definitie aan of gebruik een onderhouden pakket in plaats van dezelfde defecte Compose-configuratie steeds opnieuw te installeren. In de oorspronkelijke thread verwees het Coolstore-pakket naar een Tika-image waarvan de gebruiker dacht dat die onjuist was, terwijl een BigBear-pakket na meerdere pogingen uiteindelijk wel succesvol werd geïnstalleerd.
In de thread werd nooit vastgesteld waarom de eerdere pogingen met BigBear mislukten. Daarom zou het onjuist zijn om te beweren dat alleen het wijzigen van het IP-gedeelte een universele oplossing is. De duurzame aanpak is om de Compose-configuratie van derden te vergelijken met de actuele vereisten van Paperless-ngx upstream.
Tika is een optionele Paperless-service
De actuele configuratiereferentie van Paperless-ngx legt uit dat Tika en Gotenberg optionele services zijn voor Office-documenten en het parseren van e-mails. Wanneer deze integratie is ingeschakeld, moet Paperless worden geconfigureerd met bereikbare endpoints.
Dat betekent dat een defecte Tika-service-image een installatie kan verstoren waarin de integratie is ingeschakeld, zelfs als de definitie van de Paperless-container verder geldig is.
Beschouw Coolstore en BigBear als pakketten van derden
Een reactie uit de community wees er terecht op dat Coolstore een app-bron van derden is. Een verkeerde imagereferentie in dat pakket moet aan de beheerder ervan worden gemeld en niet worden opgevat als een kernprobleem van ZimaOS.
Als een pakket uit een winkel verouderd is, vergelijk het dan met de upstream-voorbeelden voor Paperless Docker of met een ander onderhouden pakket. Bewaar je bestaande datapaden voordat je stacks wijzigt.
Bewerk of importeer de Compose-configuratie zorgvuldig opnieuw
De huidige versie van ZimaOS kan aangepaste Docker Compose-definities importeren. De handleiding voor het oplossen van problemen met aangepaste Compose-configuraties is de veiligere aanpak wanneer een appstore-definitie een verkeerde image of een niet-ondersteund veld bevat.
ZimaOS 1.7.1 vermeldt ook verbeterde compatibiliteit voor het opslaan van YAML in de actuele releaseopmerkingen. Deze verbetering herstelt niet automatisch een onjuiste imagereferentie in een repository van derden.
Voordat je Paperless opnieuw installeert
- Maak een back-up van de locaties van de Paperless-gegevens, media en database.
- Controleer of elke imagereferentie bestaat en wordt onderhouden.
- Zorg ervoor dat Paperless, de database, Redis, Tika en Gotenberg zich op de beoogde Compose-netwerken bevinden.
- Wijzig steeds slechts één mogelijke oorzaak van het probleem, zodat duidelijk is welke oplossing werkt.
Als een installatie na meerdere pogingen plotseling slaagt, zoals in de thread gebeurde, verzin dan geen oorzaak. Beschrijf het resultaat als door de gebruiker geverifieerd succes, met een nog onopgeloste oorspronkelijke fout.
