올바른 이미지를 사용하여 ARM64에서 Collabora 코드를 실행하세요.

ARM64 호스트에서 Collabora CODE 컨테이너가 즉시 종료되는 경우는 종종 잘못된 이미지 플랫폼을 사용하고 있기 때문이지만, ARM64 자체가 본질적으로 지원되지 않는 것은 아닙니다. 권한을 변경하거나 이미지를 다시 빌드하기 전에 호스트의 비트 수, 정확한 이미지 태그의 게시된 매니페스트, 그리고 Compose 플랫폼 재정의 설정을 먼저 확인하십시오. 2026년 10월 10일 기준으로 공식 CODE 이미지에는 ARM64 빌드가 포함되어 있으며, Docker Hub에는 해당 26.04.4.2.1태그가 나열되어 있습니다 linux/arm64.

1. 호스트 아키텍처와 정확한 시작 오류를 파악하십시오.

이 명령은 중지된 Collabora 컨테이너 내부가 아닌 Docker 호스트에서 실행해야 합니다. collaboraCompose 서비스에서 사용하는 이름이 다른 경우 해당 이름으로 변경하십시오.

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

64비트 ARM Linux 호스트는 일반적 으로 . aarch64에서 정보를 보고합니다 uname -m. 와 같은 값은 armv7l일반적으로 32비트 ARM 커널 플랫폼을 나타내며, 이는 와 다릅니다 linux/arm64. Docker의 아키텍처 레이블은 다른 철자를 사용할 수 있으므로, 단순히 하나의 문자열을 기계적으로 일치시키는 대신 호스트 유형, Compose 구성 및 이미지 매니페스트를 비교해야 합니다.

첫 번째 오류 메시지와 종료 상태를 확인하십시오. "linux/arm64에 대한 일치하는 매니페스트가 없습니다"는 선택한 태그에 요청된 플랫폼에 맞는 변형이 없음을 의미합니다. "실행 형식 오류"는 아키텍처 불일치 또는 명시적으로 다른 플랫폼을 강제로 선택했음을 나타냅니다. 권한 오류 또는 메모리 부족으로 인한 종료는 다른 원인일 수 있으므로 모든 재시작 루프를 ARM 호환성 실패로 간주하지 마십시오.

2. 해당 태그가 ARM64 이미지를 게시하는지 확인합니다.

호스트를 변경하기 전에 레지스트리에서 태그를 확인하십시오.

docker buildx imagetools inspect collabora/code:26.04.4.2.1

linux/arm64플랫폼 목록에서 해당 태그 를 찾아보세요 . 2026년 10월 10일 기준으로 공식 Docker Hub 태그 목록에는latest 와 모두에 대해 해당 플랫폼이 표시되었습니다 26.04.4.2.1. Collabora의 CODE 페이지에서는 x86-64, ppc64, arm64를 지원되는 호스트 아키텍처로 명시하고 있습니다. 버전이 지정된 태그는 문제 해결 시 재현하기가 더 쉽습니다. 태그와 매니페스트는 변경될 수 있으므로, 모든 이전 태그의 아키텍처가 동일하다고 가정하지 말고 배포하려는 정확한 버전을 확인하세요.

Docker는 태그가 멀티 플랫폼이고 재정의로 대상이 변경되지 않은 경우 일치하는 변형을 자동으로 선택합니다. Docker의 이미지 검사 명령은 레지스트리 이미지에 대해 게시된 플랫폼을 표시합니다.

3. AMD64 오버라이드를 제거하고 네이티브 버전을 가져옵니다.

강제 설정이 있는지 확인하기 위해 오버라이드 파일을 포함하여 해결된 Compose 서비스를 확인하십시오 platform: linux/amd64. Docker CLI 변수를 사용하여 DOCKER_DEFAULT_PLATFORM플랫폼 플래그를 허용하는 명령의 기본 플랫폼을 설정할 수도 있습니다. Compose의 platform필드는 대상 운영 체제와 아키텍처를 명시적으로 선택하므로 잘못된 오버라이드를 제거하거나 ARM64로 설정하십시오. 문제가 있는 경우 jq관련 없는 환경 값을 출력하지 않고 병합된 설정을 검사하십시오 docker compose config --format json | jq '.services.collabora | {image, platform}'. Compose 서비스 참조에서 이 필드를 정의합니다. Docker CLI 참조DOCKER_DEFAULT_PLATFORM 에 설명되어 있습니다 .

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

다음은 코드 일부입니다. 이미지 및 플랫폼 관련 줄을 기존 서비스에 병합하고 필수 설정을 유지하세요. Docker가 이미 네이티브 ARM64 매니페스트를 올바르게 선택하는 경우 이 줄은 선택 사항입니다. Compose 서비스 이름이 다른 경우 아래 명령에서 해당 부분 platform을 바꿔주세요 .collabora

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

표시된 대로 고정된 태그를 사용하거나 방금 매니페스트를 검증한 다른 릴리스를 사용하세요. 태그는 latest-arm64Docker Hub에도 표시되지만 릴리스가 변경됨에 따라 내용이 이동합니다. 버전을 고정하면 롤백 및 이후 비교가 더 예측 가능해집니다. linux/amd64네이티브 ARM64 이미지를 사용할 수 있는 경우 에뮬레이션을 우선적으로 사용하는 것은 피하세요. 에뮬레이션은 오버헤드를 발생시키고 시작 진단을 어렵게 만듭니다.

4. 아키텍처 관련 오류가 아닌 다른 오류를 진단한 후 시작 여부를 확인합니다.

네이티브 이미지가 여전히 존재하는 경우 컨테이너 권한을 확장하는 대신 로그와 상태를 사용하십시오.

표시된 컨테이너 이름 또는 ID를 사용하여 docker compose ps -a종료 상태를 확인하십시오.

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

Docker는 이러한 검사에 대한 컨테이너 검사 및 컨테이너 로그를 문서화합니다 . 아키텍처 문제를 테스트하기 위해 영구 볼륨을 삭제하거나 전체 컨테이너에 권한을 부여하지 마십시오.

다운로드한 이미지와 실행 중인 서비스를 확인하세요.

로컬 이미지가 대상 아키텍처를 보고하는지 확인하십시오.

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

예상 값은 입니다 linux/arm64. 그런 다음 docker compose ps -a안정적인 실행 상태를 확인하고 최신 로그에서 치명적인 시작 오류가 있는지 검토하십시오. 컨테이너가 스토리지 플랫폼 또는 리버스 프록시에 연결되면 /hosting/discovery구성된 Collabora URL을 통해 요청하고 테스트 문서를 여십시오. 사용 가능한 버전과 플랫폼 매니페스트가 변경될 수 있으므로 업그레이드 전에 레지스트리의 태그 목록을 다시 확인하십시오.