Docker + Colima Autostart Setup (macOS)

Последнее обновление: 2026-06-24

Текущие параметры Colima

colima start --cpu 8 --memory 24 --disk 100

virtiofs mount type
Build cache volume buildx_buildkit_arm64builder0_state занимает до 8+ GB и не чистится автоматически. См. tech/docker-mac-disk-issues.

1. Install dependencies

brew install docker docker-compose colima

2. Start Colima manually (first run)

colima start --cpu 6 --memory 12 --disk 100

3. Stop Colima

colima stop

4. Check status

colima status
colima list

5. Create LaunchAgent (auto-start Colima)

File: ~/Library/LaunchAgents/com.colima.start.plist

<?xml version="1.0" encoding="UTF-8"?>
<plist version="1.0">
  <dict>
    <key>Label</key>
    <string>com.colima.start</string>

    <key>ProgramArguments</key>
    <array>
      <string>/bin/bash</string>
      <string>-c</string>
      <string>export PATH=/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin && colima start</string>
    </array>

    <key>RunAtLoad</key>
    <true/>

    <key>StandardOutPath</key>
    <string>/tmp/colima.out</string>

    <key>StandardErrorPath</key>
    <string>/tmp/colima.err</string>
  </dict>
</plist>

6. Load LaunchAgent

launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.colima.start.plist

7. Unload LaunchAgent

launchctl bootout gui/$(id -u) ~/Library/LaunchAgents/com.colima.start.plist

8. Restart / trigger manually

launchctl kickstart -k gui/$(id -u)/com.colima.start

9. Check logs

cat /tmp/colima.out
cat /tmp/colima.err

10. Docker usage

🔴 Команда — docker-compose, а НЕ docker compose. В homebrew-установке compose приезжает отдельным бинарём, не плагином, поэтому docker compose … падает с docker: unknown command: docker compose (выглядит как сломанный Docker — не сломан). Проверено 2026-09-26: CLI 29.4.1, compose 5.1.3.

docker-compose up -d          # ✅
docker-compose config         # валидация (флага --quiet у этой версии НЕТ)
docker compose up -d          # ❌ unknown command

Start containers:

docker-compose up -d

Check running containers:

docker ps

Подробнее про границы проброса путей в контейнер (virtiofs) и билдер arm64builder: tech/macos-docker-virtiofs-mount-limits.

Behavior

Colima auto-starts on login via LaunchAgent
Docker auto-restores containers with restart: unless-stopped
No need to run docker compose up on every reboot

3.5 KiB Executable File Raw Blame History Unescape Escape