Gemenskapslösning

Felaktig Compose för Paperless-ngx på ZimaOS: Åtgärda Tika på ett säkert sätt

A Coolstore Paperless-ngx install failed around the Tika image; the user later got a BigBear package running after several attempts, but the earlier failure cause remained unverified.

Om en Paperless-ngx-app från tredje part misslyckas eftersom dess Compose-fil hänvisar till en felaktig Tika-avbildning bör du åtgärda appdefinitionen eller använda ett underhållet paket i stället för att installera om samma trasiga Compose upprepade gånger. I den ursprungliga tråden hänvisade Coolstore-paketet till en Tika-avbildning som användaren ansåg vara felaktig, medan ett BigBear-paket till slut installerades korrekt efter flera försök.

Tråden fastställde aldrig varför de tidigare BigBear-försöken misslyckades, så det vore felaktigt att säga att det alltid räcker att ändra endast IP-avsnittet. Den hållbara metoden är att jämföra tredjeparts-Compose-filen med de aktuella kraven från Paperless-ngx uppströms.

Tika är en valfri Paperless-tjänst

Den aktuella konfigurationsreferensen för Paperless-ngx förklarar att Tika och Gotenberg är valfria tjänster som används för Office-dokument och e-posttolkning. Paperless måste konfigureras med åtkomliga slutpunkter när denna integration är aktiverad.

Det innebär att en felaktig Tika-tjänstavbildning kan bryta en installation som aktiverar integrationen, även om den centrala Paperless-containerdefinitionen i övrigt är korrekt.

Betrakta Coolstore och BigBear som tredjepartspaket

Ett svar från communityn påpekade korrekt att Coolstore är en appkälla från tredje part. En felaktig avbildningsreferens i det paketet bör rapporteras till dess underhållare i stället för att tolkas som ett kärnfel i ZimaOS.

Om ett butikspaket är föråldrat bör du jämföra det med aktuella Paperless Docker-exempel eller med ett annat underhållet paket. Säkerhetskopiera dina befintliga datasökvägar innan du ändrar stackar.

Redigera eller importera Compose-filen på nytt med försiktighet

Aktuella ZimaOS kan importera anpassade Docker Compose-definitioner. Felsökningsguiden för anpassad Compose är det säkrare alternativet när en appbutiksdefinition innehåller en felaktig avbildning eller ett fält som inte stöds.

ZimaOS 1.7.1 listar även förbättrad kompatibilitet för sparande av YAML i de aktuella versionsanteckningarna. Den förbättringen reparerar inte automatiskt en felaktig avbildningsreferens i ett tredjepartsarkiv.

Innan du installerar om Paperless igen

  • Säkerhetskopiera Paperless-data, media och databasplatser.
  • Bekräfta att varje avbildningsreferens finns och underhålls.
  • Se till att Paperless, dess databas, Redis, Tika och Gotenberg finns på de avsedda Compose-nätverken.
  • Ändra endast en felkälla åt gången så att den fungerande lösningen kan identifieras.

Om en installation plötsligt lyckas efter flera försök, som i tråden, bör du inte hitta på en orsak. Märk i stället resultatet som en användarverifierad framgång med ett olöst ursprungligt fel.