Skip to content

chore: replace podman with colima and docker - #41

Merged
jmeridth merged 1 commit into
mainfrom
chore/podman-to-colima-docker
Nov 11, 2026
Merged

jmeridth merged 1 commit into
mainfrom
chore/podman-to-colima-docker

Conversation

@jmeridth

Copy link
Copy Markdown
Owner

What/Why

Run Docker on Colima on macOS and Docker Engine from Docker's apt repo on Linux. This drops Podman and never uses Docker Desktop. Setup also adds Homebrew's CLI plugin dir to ~/.docker/config.json so docker buildx and docker compose load.

Proof it works

  • The Linux install path ran clean in ubuntu:24.04 and debian:12 containers. It verified Docker's apt key fingerprint, installed Docker 29.9.3 with buildx and compose, and added the user to the docker group.
  • The plugin-dir step kept existing auths and 600 permissions, appended to an existing list, and was a no-op on a second run.
  • brew bundle check passes on macOS. docker run hello-world, docker buildx version, and docker compose version work on Colima.

Risk

Low. brew bundle never uninstalls, so existing machines keep Podman until removed by hand (steps below). The docker group grants root-equivalent access on Linux.

Migrating an existing Mac

After git pull and ./setup:

  1. Export any Podman volumes you want to keep.
  2. colima start --vm-type vz --mount-type virtiofs --vz-rosetta --cpu 6 --memory 12 --disk 100
  3. podman machine rm -f, then brew uninstall podman podman-compose krunkit gvproxy, brew uninstall --cask podman-desktop, brew untap libkrun/krun, and rm -rf ~/.local/share/containers ~/.config/containers.

AI role

Claude Opus 5.5 made the edits and drafted this description. I chose the runtime and install method and reviewed the diff.

What/Why

Run Docker on Colima on macOS and Docker Engine from Docker's apt repo
on Linux. Drop Podman and never use Docker Desktop. Setup now adds
Homebrew's CLI plugin dir to ~/.docker/config.json so buildx and
compose load.

Proof it works

brew bundle check and shellcheck pass. The Linux install path ran clean
in ubuntu:24.04 and debian:12 containers: it verified Docker's apt key
fingerprint, installed Docker 29.9.3 with buildx and compose, and added
the user to the docker group. The plugin-dir step kept existing auths
and 600 permissions, appended to an existing list, and was a no-op on a
second run.

Risk

Low. brew bundle never uninstalls, so existing machines must remove
Podman by hand. The docker group grants root-equivalent access.

AI role

Claude Opus 5.5 made the edits and drafted this message. jmeridth chose
the runtime and install method and reviewed the diff.

Review focus

The Docker apt repo setup in scripts/install-packages.sh.

Signed-off-by: jmeridth <jmeridth@gmail.com>
@jmeridth jmeridth self-assigned this Nov 11, 2026
@github-actions github-actions Bot added the maintenance Maintenance and chores label Nov 11, 2026
@jmeridth
jmeridth marked this pull request as ready for review November 11, 2026 23:42
@jmeridth
jmeridth merged commit 5482875 into main Nov 11, 2026
5 checks passed
@jmeridth
jmeridth deleted the chore/podman-to-colima-docker branch November 11, 2026 23:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

maintenance Maintenance and chores

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant