기존 CasaOS Coolify 튜토리얼은 프로젝트를 소개하는 참고 자료로는 여전히 유용하지만, 현재 ZimaOS에 바로 적용할 수 있는 설치 방법은 아닙니다. 핵심적인 차이는 Coolify가 관리하는 서버에 SSH 키로 다시 접속할 수 있어야 하는 반면, ZimaOS는 기본 시스템의 일부를 읽기 전용으로 보호한다는 점입니다.
2026년에 해당 포럼 스레드에 추가된 후속 내용에서 문제는 정확히 이것이었습니다. Coolify는 자신의 공개 키를 ~/.ssh/authorized_keys에 복사하라고 요청했지만, 사용자는 일반적으로 쓰기 가능한 루트 SSH 경로를 찾을 수 없었습니다. 이를 Coolify 자체가 고장 났다는 증거가 아니라 플랫폼 통합 문제로 보아야 합니다.
CasaOS 가이드가 ZimaOS에 그대로 적용되지 않는 이유
현재 Coolify 문서에 따르면 셀프 호스팅 서버에는 SSH 액세스가 필요하며, Coolify가 사용하는 공개 키는 관리 대상 계정에서 인증되도록 설정해야 합니다. 또한 설치 프로그램은 /data/coolify 아래에 데이터를 생성하고 호스트의 Docker를 관리할 수 있어야 합니다. 이러한 전제는 일반적인 Linux 서버에서는 보편적입니다.
하지만 ZimaOS는 어플라이언스형 NAS 운영 체제입니다. 공식 ZimaOS SSH 가이드는 개발자 모드에서 SSH를 활성화하는 방법을 설명하지만, 일반적인 Linux 경로가 모두 쓰기 가능하거나 시스템 업데이트 후에도 유지된다고 보장하지는 않습니다.
현재 Coolify에 필요한 조건
현재 Coolify 설치 가이드에는 SSH 액세스와 Docker 지원을 제공하는 64비트 Linux 서버, 최소 2개의 CPU 코어, 2GB RAM, 30GB의 여유 저장 공간이 필요하다고 나와 있습니다. 또한 기존 서비스와의 충돌을 줄이기 위해 새 서버를 사용할 것을 권장합니다.
Coolify는 Coolify가 실행되는 동일한 머신을 관리하는 경우에도 SSH를 사용합니다. OpenSSH 설정 문서에서는 특히 키 기반 인증을 요구합니다. 따라서 CasaOS 앱 정의를 단순히 가져오는 것만으로는 호스트 측 SSH 요구 사항이 사라지지 않습니다.
ZimaOS 홈 서버에서 더 안전하게 배포하는 방법
애플리케이션 배포를 주된 목적으로 Coolify를 사용하려는 경우, 전용 Debian/Ubuntu 서버나 VM처럼 Coolify가 지원하는 전제 조건에 부합하는 Linux 환경에서 Coolify를 실행하는 것이 가장 깔끔한 설계입니다. 그러면 ZimaOS는 NAS 스토리지와 기타 서비스를 계속 담당하고, Coolify의 호스트 수준 변경 사항은 보호된 ZimaOS 기본 시스템에 영향을 주지 않습니다.
그래도 ZimaOS에서 직접 실험하려면 먼저 애플리케이션 데이터를 백업하고 SSH 키와 Coolify 상태가 정확히 어디에 저장되어 유지되는지 확인하세요. 한 커뮤니티 학습 저장소에서 ZimaOS에 맞춘 작업 진행 상황을 확인할 수 있지만, IceWhale이 지원하는 설치 경로가 아니라 커뮤니티 실험으로 보아야 합니다. 저장소는 다음과 같습니다: ZimaOS Coolify 학습 저장소.
소규모 상시 운영 배포 호스트를 구축하려는 사용자라면 소형 홈 서버로 x86 하드웨어 계층을 구성할 수 있습니다. 다만 운영 체제 선택은 실행하려는 소프트웨어에 맞춰야 합니다.
결론
해당 포럼 스레드는 ZimaOS에서 Coolify를 원클릭으로 설치하는 방법을 제시하지 않습니다. 오히려 CasaOS 방법이 ZimaOS의 SSH 영속성 경계에 도달한다는 점을 보여 줍니다. 최신 Coolify 요구 사항을 기준으로 삼고, 가장 예측 가능한 업그레이드 및 복구 경로를 원한다면 일반적인 Linux 환경에서 Coolify를 분리해 운영하세요.
