일부 공급업체의 Docker 설치 프로그램은 Linux 루트 파일 시스템 바로 아래에 애플리케이션 디렉터리를 만들 수 있다고 가정합니다. 설치 프로그램이 /app과 같은 호스트 경로를 요구하면 ZimaOS의 어플라이언스형 설계와 충돌합니다.
2026년 1월에 시작된 이 스레드는 ZimaOS 루트 파일 시스템을 쓰기 가능하게 만드는 것보다 더 나은 해결책에 도달했습니다. ONLYOFFICE Workspace가 /media 아래의 영구 스토리지를 사용하도록 구성하고 Community 설치 유형을 명시적으로 선택하는 방법입니다.
설치 프로그램을 맞추기 위해 ZimaOS 루트를 쓰기 가능하게 만들지 마세요
원래 배포에는 데이터베이스, 검색, 문서, 메일, 커뮤니케이션 및 관리 서비스를 위한 여러 컨테이너가 포함되어 있었습니다. 공급업체 설치 프로그램은 /app을 요구했지만, 사용자는 실제 데이터를 대용량 ZimaOS 데이터 드라이브에 저장하려고 했습니다.
커뮤니티는 논의를 ZimaOS 기본 파일 시스템을 영구적으로 수정하는 방향에서 올바르게 벗어나도록 이끌었습니다. 어플라이언스 OS 업데이트는 루트 파일 시스템에 적용된 지원되지 않는 변경 사항을 대체하거나 무효화할 수 있습니다.
공급업체 설치 프로그램에는 구성 가능한 기본 디렉터리가 있었습니다
설치 프로그램 스크립트를 확인한 후, 사용자는 저장 위치가 실제로 하드 코딩된 것이 아니라는 사실을 알게 되었습니다. 기본 디렉터리는 기본 루트 수준 경로에서 ZimaOS 데이터 드라이브 아래의 영구 위치로 변경할 수 있었습니다.
이 방식이 더 안전한 아키텍처인 이유는 컨테이너와 애플리케이션 데이터는 쓰기 가능한 스토리지에 유지하고, ZimaOS 시스템 이미지는 운영 체제가 관리하도록 할 수 있기 때문입니다.
Community 설치 유형을 명시적으로 선택하세요
이후 사용자는 두 번째 문제를 보고했습니다. 기본 디렉터리를 변경한 뒤 설치 프로그램이 Enterprise 에디션으로 전환될 수 있었습니다. 소프트웨어 공급업체와 협의한 결과, Community 배포에는 적절한 설치 유형을 선택해야 한다는 사실을 확인했습니다.
현재 ONLYOFFICE 안내에도 Community와 Enterprise 설치 유형이 별도로 표시되어 있습니다. 오래전에 다운로드한 스크립트를 수정하기 전에 현재 설치 프로그램에서 Workspace Community를 선택하는 스크립트 매개변수를 확인하세요.
과거 포럼에 언급된 파일명이 아니라 현재 ONLYOFFICE 스크립트를 사용하세요
2026년 포럼 답변에는 이전 설치 프로그램 파일명이 언급되었습니다. 현재 ONLYOFFICE Workspace 안내에서는 Docker 배포에 workspace-install.sh를 사용하며, 지원되는 매개변수는 별도로 설명합니다.
현재 업스트림 프로세스와 시스템 요구 사항은 관리되는 Workspace Community Docker 설치 흐름에 설명되어 있습니다.
Docker Compose는 여전히 더 투명한 대안입니다
커뮤니티 논의에서는 대규모 설치 프로그램 스크립트에 의존하는 대신 Compose로 스택을 배포하는 방법도 검토했습니다. 이 방식은 배포 전에 이미지 에디션, 볼륨 경로, 네트워크 및 영구 스토리지를 더 쉽게 검토할 수 있게 해 줍니다.
현재 ZimaOS로 여러 컨테이너 스택을 가져오는 경우 표준 런타임 설정은 Docker Compose에 지정해야 합니다. ZimaOS가 Docker Compose 구성을 처리하는 방식에 대한 현재 설명을 참고하면 공급업체의 스토리지 경로와 ZimaOS 앱 메타데이터를 분리하는 데 도움이 됩니다.
ZimaOS의 ONLYOFFICE FAQ
ZimaOS 루트 파일 시스템을 쓰기 가능하게 만들어야 하나요?
최종 스레드의 어떤 해결책도 그렇게 할 필요가 없었습니다. 더 나은 방법은 공급업체의 기본 디렉터리를 쓰기 가능한 영구 스토리지에 두는 것이었습니다.
/app은 정말 필수였나요?
사용자의 공급업체는 최종적으로 설치 프로그램의 기본 디렉터리를 변경할 수 있다고 확인했습니다. 따라서 호스트가 루트 수준의 /app 경로 아래에 애플리케이션을 저장할 필요는 없었습니다.
왜 잘못된 에디션이 표시되었나요?
사용자는 기본 디렉터리를 변경하자 Enterprise로 기본 설정되는 설치 프로그램의 동작이 드러났다는 사실을 확인했습니다. Community 설치 유형을 명시적으로 선택하면 이 문제가 해결된다고 보고했습니다.
2026년 포럼의 명령을 그대로 복사해야 하나요?
아니요. 배포 전에 ONLYOFFICE의 현재 설치 프로그램 파일명과 매개변수를 최신 공식 안내와 대조해 확인해야 합니다.
