Ejecuta Collabora CODE en ARM64 con la imagen correcta.

Un contenedor Collabora CODE que finaliza inmediatamente en un host ARM64 suele estar utilizando la plataforma de imagen incorrecta, pero ARM64 en sí mismo no carece de soporte inherente. Comience por verificar la arquitectura (32 o 64 bits) del host, el manifiesto publicado de la etiqueta de imagen exacta y cualquier anulación de plataforma de Compose antes de cambiar los permisos o reconstruir la imagen. Según la verificación del 10 de octubre de 2026, la imagen oficial de CODE incluye compilaciones para ARM64; Docker Hub enumera la 26.04.4.2.1etiqueta para linux/arm64.

1. Identifique la arquitectura del host y el error de inicio exacto.

Ejecute estos comandos en el host de Docker, no dentro del contenedor de Collabora detenido. Reemplace collaborasi su servicio Compose utiliza otro nombre:

uname -m
docker info --format '{{.Architecture}}'
docker compose ps -a
docker compose logs --tail=100 collabora

Un host Linux ARM de 64 bits suele informar aarch64desde uname -m. Un valor como armv7lsuele identificar una plataforma de kernel ARM de 32 bits, que es diferente de linux/arm64. La etiqueta de arquitectura de Docker puede usar otra ortografía, así que compare el tipo de host, la configuración de Compose y el manifiesto de la imagen en lugar de hacer coincidir una cadena mecánicamente.

Lea el primer mensaje fatal y el estado de salida. «No se encontró ningún manifiesto que coincida con linux/arm64» significa que la etiqueta seleccionada no tiene una variante compatible con la plataforma solicitada. «Error de formato de ejecución» sugiere una incompatibilidad de arquitectura o una plataforma externa forzada explícitamente. Un error de permisos o un fallo por falta de memoria tienen una causa diferente; no considere cada reinicio como un fallo de compatibilidad con ARM.

2. Confirma que la etiqueta publica una imagen ARM64.

Inspeccione la etiqueta en el registro antes de cambiar el host:

docker buildx imagetools inspect collabora/code:26.04.4.2.1

Busque linux/arm64en la lista de plataformas. El 10 de octubre de 2026, la lista oficial de etiquetas de Docker Hub mostró que la plataforma era compatible con ambos latesty . La página CODE26.04.4.2.1 de Collabora identifica x86-64, ppc64 y arm64 como arquitecturas de host compatibles. La etiqueta versionada es más fácil de reproducir durante la resolución de problemas. Las etiquetas y los manifiestos pueden cambiar, así que inspeccione la versión exacta que planea implementar en lugar de asumir que todas las etiquetas históricas tienen las mismas arquitecturas.

Docker selecciona automáticamente una variante coincidente cuando la etiqueta es multiplataforma y ninguna anulación modifica el destino. El comando de inspección de imágenes de Docker muestra las plataformas publicadas para una imagen de registro.

3. Elimine una anulación de AMD64 y extraiga la variante nativa.

Compruebe el servicio Compose resuelto, incluidos los archivos de anulación, para una anulación forzada platform: linux/amd64. La variable de la CLI de Docker DOCKER_DEFAULT_PLATFORMtambién puede establecer la plataforma predeterminada para los comandos que aceptan una bandera de plataforma. El platformcampo de Compose selecciona explícitamente el sistema operativo y la arquitectura de destino, así que elimine una anulación incorrecta o establézcala en ARM64. Si tiene jq, inspeccione la configuración combinada sin imprimir valores de entorno no relacionados: docker compose config --format json | jq '.services.collabora | {image, platform}'. La referencia del servicio Compose define este campo. DOCKER_DEFAULT_PLATFORMestá documentado en la referencia de la CLI de Docker .

services:
  collabora:
    image: collabora/code:26.04.4.2.1
    platform: linux/arm64

Este es un fragmento: combine las líneas de imagen y plataforma con su servicio existente y conserve la configuración requerida. Si Docker ya selecciona correctamente el manifiesto ARM64 nativo, la platformlínea es opcional. Reemplace collaboraen los comandos a continuación si su servicio Compose tiene otro nombre.

docker compose pull collabora
docker compose up -d --force-recreate collabora

Utilice la etiqueta fijada como se muestra u otra versión cuyo manifiesto haya verificado recientemente. latest-arm64Docker Hub también incluye la etiqueta, pero su contenido cambia con las versiones. Fijar una versión facilita la previsibilidad de una reversión y una comparación posterior. Evite forzar linux/amd64la emulación como primera solución cuando haya una imagen ARM64 nativa disponible; la emulación añade sobrecarga y dificulta el diagnóstico del arranque.

4. Diagnosticar fallos no relacionados con la arquitectura y, a continuación, verificar el inicio.

Si la imagen nativa aún existe, utilice el registro y el estado en lugar de ampliar los privilegios del contenedor:

Utilice el nombre o ID del contenedor que se muestra docker compose ps -apara inspeccionar su estado de salida:

docker inspect --format 'status={{.State.Status}} exit={{.State.ExitCode}} oom={{.State.OOMKilled}} error={{.State.Error}}' CONTAINER

Docker documenta la inspección de contenedores y los registros de los mismos para estas comprobaciones. No elimine volúmenes persistentes ni otorgue privilegios a todo el contenedor solo para probar un problema de arquitectura.

Compruebe la imagen descargada y el servicio en ejecución.

Confirme que la imagen local informa la arquitectura de destino:

docker image inspect collabora/code:26.04.4.2.1 --format '{{.Os}}/{{.Architecture}}'

El valor esperado es linux/arm64. A continuación, compruebe docker compose ps -aque el estado de ejecución sea estable y revise los registros más recientes en busca de errores de inicio fatales. Una vez que el contenedor esté conectado a su plataforma de almacenamiento o proxy inverso, realice una solicitud /hosting/discoverya través de la URL de Collabora configurada y abra un documento de prueba. Vuelva a comprobar la lista de etiquetas del registro antes de las actualizaciones, ya que las versiones disponibles y los manifiestos de la plataforma pueden cambiar.