Colima Guide: A Smooth Docker Desktop Alternative, a ‘Lifesaver’ for RAM on macOS

Docker tutorial - IT technology blog
Docker tutorial - IT technology blog

Quick start: Running Docker with Colima in 5 minutes

It only takes exactly 3 commands to say “goodbye” to Docker Desktop. I guarantee its startup speed is much faster than sitting around waiting for that whale icon to blink in your Menu Bar.

Step 1: Install via Homebrew (macOS)

# Install Colima and Docker CLI
brew install colima docker docker-compose

Step 2: Start Colima

colima start

Step 3: Verify the results

docker ps
docker run hello-world

That’s it. You now have a complete Docker environment. No need for a nearly 600MB installer, and no cluttered dashboard interface.

Why I chose Colima over Docker Desktop

The sight of a 16GB Mac suddenly running hot, with fans sounding like a jet engine just because Docker Desktop is “hogging” 6-7GB of RAM, is all too familiar. For large enterprises, paying licensing fees for Docker Desktop is also a significant hurdle. I needed something lightweight, free, and most importantly, something that allows for deep configuration tweaks.

Colima (Container on Lima) is actually a runtime running on an ultra-compact Linux virtual machine. Docker cannot run directly on the macOS kernel. Docker Desktop solves this with a rather bulky VM. In contrast, Colima streamlines everything to maximize resource savings.

The numbers speak for themselves:

  • Idle RAM: Docker Desktop consumes ~1.5GB – 3GB, while Colima only takes about 600MB – 800MB.
  • Startup time: Colima takes about 15-20 seconds to be ready, 3 times faster than Docker Desktop.
  • Licensing: 100% free for both individuals and businesses (Open Source).
  • Compatibility: Supports maximizing the power of M1/M2/M3 chips via Apple’s native virtualization framework.

Configuring VM Runtime for optimal performance

By default, Colima only allocates 2 CPUs and 2GB of RAM. For real-world projects running multiple microservices, this is definitely not enough. Instead of digging through a Settings menu, you just need a single command to redefine the VM’s power.

# Allocate 4 CPUs, 8GB RAM, and 60GB disk space
colima start --cpu 4 --memory 8 --disk 60

Tips for Apple Silicon users (M1, M2, M3)

If you own an Apple Silicon chip, use vz as the VM type. This is Apple’s native virtualization framework, which makes file mounting and running containers significantly faster. Don’t forget to enable Rosetta to handle images built for Intel chips as well:

colima start --vm-type=vz --vz-rosetta --arch aarch64

During my workflow, if I need to inspect long, winding JSON config files from Docker, I usually toss them into JSON Formatter. It helps me visualize the structure much faster than scrolling through the Terminal.

Full integration with Docker CLI

Many people mistakenly think Colima replaces the docker command itself. In reality, Colima acts as the “power generator” (Docker Engine). You still use the Docker CLI to control it as usual.

After running colima start, the system automatically configures the Unix socket. However, if VS Code or Postman doesn’t recognize Docker, check your context:

docker context ls

An asterisk (*) on the colima line means everything is set. If it’s still on default, switch over using the command:

docker context use colima

Real-world troubleshooting experience

No tool is perfect. Sometimes Colima can hang if you leave your Mac in sleep mode for too long or switch networks frequently. Here are 3 tricks I often use:

  1. Restart: The colima restart command solves 90% of network connection issues.
  2. Clean the environment: If the configuration is severely glitched, use colima delete. This wipes the old VM so you can recreate it from scratch in seconds.
  3. Experience Kubernetes: Instead of installing the heavy Minikube, just run colima start --kubernetes to get a lightweight K3s cluster for deployment testing.

A small tip: The main configuration file is located at ~/.colima/default/colima.yaml. You can edit this directly if you want deep customization for DNS or SSH.

Conclusion

Switching to Colima is the simplest way to bring smoothness back to your MacBook. It’s lightweight, free, and highly professional for developer workflows. If you’re tired of watching your machine lag every time you turn on Docker, try installing Colima today. The real-world experience definitely won’t disappoint you.

Share: