以前のCasaOS Coolifyチュートリアルは、プロジェクトを知るための手がかりとしては今でも役立ちますが、現行のZimaOSにそのまま適用できるインストール手順ではありません。主な違いは、Coolifyが管理対象サーバーへのSSH鍵アクセスを必要とする一方で、ZimaOSでは基盤システムの一部が読み取り専用で保護されていることです。
2026年にフォーラムスレッドへ追記された内容では、問題点はまさにここでした。Coolifyは公開鍵を~/.ssh/authorized_keysにコピーするよう求めましたが、ユーザーは通常の書き込み可能なroot 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環境で実行し、NASストレージやその他のサービスはZimaOSに引き続き任せることです。これにより、Coolifyによるホストレベルの変更を、保護されたZimaOSの基盤システムから切り離せます。
ZimaOS上で直接試したい場合は、まずアプリケーションデータをバックアップし、SSH鍵とCoolifyの状態が実際にどこへ保存されるのか、またその状態がどのように永続化されるのかを確認してください。コミュニティの学習用リポジトリではZimaOS固有の作業が進められていますが、IceWhaleがサポートするインストール方法ではなく、コミュニティによる実験として扱うべきです。参照先はこちらです：ZimaOS Coolify学習用リポジトリ。
小規模な常時稼働のデプロイホストを構築するユーザーには、コンパクトなホームサーバーでx86ハードウェア層を用意する方法もあります。ただし、オペレーティングシステムの選択は、実行するソフトウェアの要件に合わせる必要があります。
結論
このフォーラムスレッドから、ZimaOS上でCoolifyをワンクリック導入できる方法が確立されているとは言えません。むしろ、CasaOSの手順がZimaOS上でSSHの永続化境界に突き当たることを示しています。現在のCoolify要件を正確な基準とし、アップグレードや復旧をできるだけ予測しやすくしたい場合は、Coolifyを一般的なLinux環境に分離して運用してください。
