Solución de la comunidad

Compose defectuoso de Paperless-ngx en ZimaOS: cómo reparar Tika de forma segura

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.

Si una aplicación de Paperless-ngx de terceros falla porque su archivo Compose hace referencia a una imagen de Tika incorrecta, corrige la definición de la aplicación o utiliza un paquete mantenido, en lugar de reinstalar repetidamente el mismo Compose defectuoso. En el hilo original, el paquete de Coolstore apuntaba a una imagen de Tika que el usuario consideraba incorrecta, mientras que un paquete de BigBear finalmente se instaló correctamente después de varios intentos.

El hilo nunca estableció por qué fallaron los intentos anteriores con BigBear, por lo que sería inexacto afirmar que cambiar únicamente la sección de IP es una solución universal. El enfoque duradero consiste en comparar el Compose de terceros con los requisitos actuales de Paperless-ngx.

Tika es un servicio opcional de Paperless

La referencia de configuración de Paperless-ngx actual explica que Tika y Gotenberg son servicios opcionales utilizados para documentos de Office y el análisis de correos electrónicos. Paperless debe configurarse con endpoints accesibles cuando esta integración está habilitada.

Esto significa que una imagen de servicio de Tika defectuosa puede romper una instalación que habilita la integración, aunque la definición del contenedor principal de Paperless sea válida por lo demás.

Trata Coolstore y BigBear como paquetes de terceros

Una respuesta de la comunidad señaló correctamente que Coolstore es una fuente de aplicaciones de terceros. Una referencia de imagen incorrecta en ese paquete debe notificarse a su mantenedor, en lugar de interpretarse como un defecto del núcleo de ZimaOS.

Si un paquete de la tienda está desactualizado, compáralo con los ejemplos de Docker de Paperless o con otro paquete mantenido. Haz una copia de seguridad de las rutas de datos existentes antes de cambiar las pilas.

Edita o vuelve a importar el Compose con cuidado

Las versiones actuales de ZimaOS pueden importar definiciones personalizadas de Docker Compose. La guía de solución de problemas de Compose personalizado es la opción más segura cuando la definición de una tienda de aplicaciones contiene una imagen incorrecta o un campo no compatible.

ZimaOS 1.7.1 también incluye una compatibilidad mejorada para guardar archivos YAML en las notas de la versión actuales. Esa mejora no corrige automáticamente una referencia de imagen incorrecta en el repositorio de terceros.

Antes de volver a instalar Paperless

  • Haz una copia de seguridad de las ubicaciones de datos, medios y base de datos de Paperless.
  • Confirma que todas las referencias de imagen existen y reciben mantenimiento.
  • Mantén Paperless, su base de datos, Redis, Tika y Gotenberg en las redes de Compose previstas.
  • Cambia solo una fuente del fallo a la vez para poder identificar la solución correcta.

Si una instalación tiene éxito repentinamente después de varios reintentos, como ocurrió en el hilo, no inventes una causa. Mantén el resultado etiquetado como un éxito verificado por el usuario, con el fallo original aún sin resolver.