はじめに
Colimaのセットアップ方法と使い方を、Dockerランタイムに絞って紹介します。
「Colima」とは?
macOS用のコンテナランタイムです。
OSSであり、Docker Desktopの代替としてよく使われています。
環境
- macOS: Tahoe 26.3.1 (a)
- Colima: 0.10.1
セットアップ
READMEのGetting Startedに従ってセットアップします。
Colimaのインストール
まずはColimaをインストールします。
Homebrewでもいいですが、私はmiseでインストールしました。
$ mise use --global colima@0.10.1
Dockerクライアントのインストール
DockerランタイムにはDockerクライアントが必要なのでインストールします。
$ brew install docker
Docker Composeのインストール
必要に応じてDocker Composeもインストールします。
$ brew install docker-compose
docker composeを使えるようにする
Docker Composeをインストールすると docker-compose up -d は実行できるようになりますが、 docker compose up は実行できません。
以下を参考に docker compose を実行できるようにします。
まず HOMEBREW_PREFIX のパスを確認します。
$ brew --config | grep HOMEBREW_PREFIX
HOMEBREW_PREFIX: /opt/homebrew
そこに docker-compose のバイナリがあるので、 docker のプラグイン置き場へシンボリックリンクを作成します。
$ mkdir -p ~/.docker/cli-plugins
$ ln -sfn /opt/homebrew/opt/docker-compose/bin/docker-compose ~/.docker/cli-plugins/docker-compose
これで docker compose が使えるようになります。
Limaのインストール
READMEには記載が見当たらなかったのですが、ColimaはLimaに依存しているのでインストールします。
$ brew install lima
Limaはコンテナの実行に重点をおいたLinux仮想マシンです。
Limaをインストールすると limactl コマンドが使えるようになり、 colima start しても以下のエラーが発生しなくなります。
$ colima start
FATA[0000] lima compatibility error: error checking Lima version: exec: "limactl": executable file not found in
$PATH
使い方
colima start を実行したあと、通常の docker コマンドを実行するだけです。
$ colima start
INFO[0000] starting colima
INFO[0000] runtime: docker
INFO[0002] creating and starting ... context=vm
INFO[0002] downloading disk image ... context=vm
INFO[0035] provisioning ... context=docker
INFO[0036] starting ... context=docker
INFO[0038] done
$ docker compose up
...
再度 colima start を実行すると警告が出ます。実行は無視されるので問題ありません。
$ colima start
WARN[0001] already running, ignoring
おわりに
Docker Desktopを使わなくても簡単にDockerコンテナを起動できました ![]()
ColimaはDocker以外にContainerdやIncusのランタイムにも対応しているので、Dockerを使っていなくてもぜひ使ってみてください。