Here's how you do it.

If you can use Homebrew, do

Copybrew install docker-compose

and pay heed to the notes after the installer runs. They tell you to add

Copy "cliPluginsExtraDirs": [
     "/opt/homebrew/lib/docker/cli-plugins"
 ]

to your ~/.docker/config.json file.

I don't know if Homebrew also installs Credentials Helper with Compose, so you might have to do:

Copybrew install docker-credential-helper

If you can't use Homebrew, I think you'll have to do the following.

Install Credentials Helper using Docker's instructions here.

Go into ~/.docker/config.json and make sure the value for credsStore is osxkeychain. My file looks like:

Copy{
    "auths": {},
    "credsStore": "osxkeychain",
    "currentContext": "colima",
    "plugins": {
        "debug": {
            "hooks": "exec"
        },
        "scout": {
            "hooks": "pull,buildx build"
        }
    },
    "features": {
        "hooks": "true"
    }
}

Download latest Docker Compose from here for your architecture (aarch64 for Apple Silicon): https://github.com/docker/compose/releases/latest

Copy the executable to /usr/local/bin, naming it docker-compose.

From there, make sure it's executable:

Copysudo chmod +x docker-compose

Clear Apple's scareware:

Copysudo xattr -d com.apple.quarantine docker-compose

As in the Homebrew case, add

Copy "cliPluginsExtraDirs": [
     "/opt/homebrew/lib/docker/cli-plugins"
 ]

to your ~/.docker/config.json file.

Open a new terminal session and try

Copydocker compose version

If that doesn't work, try

Copydocker-compose version

If that works, the cliPluginsExtraDirs entry in the config.json file isn't working.

Answer from Oscar on Stack Overflow
Top answer
1 of 1
46

Here's how you do it.

If you can use Homebrew, do

Copybrew install docker-compose

and pay heed to the notes after the installer runs. They tell you to add

Copy "cliPluginsExtraDirs": [
     "/opt/homebrew/lib/docker/cli-plugins"
 ]

to your ~/.docker/config.json file.

I don't know if Homebrew also installs Credentials Helper with Compose, so you might have to do:

Copybrew install docker-credential-helper

If you can't use Homebrew, I think you'll have to do the following.

Install Credentials Helper using Docker's instructions here.

Go into ~/.docker/config.json and make sure the value for credsStore is osxkeychain. My file looks like:

Copy{
    "auths": {},
    "credsStore": "osxkeychain",
    "currentContext": "colima",
    "plugins": {
        "debug": {
            "hooks": "exec"
        },
        "scout": {
            "hooks": "pull,buildx build"
        }
    },
    "features": {
        "hooks": "true"
    }
}

Download latest Docker Compose from here for your architecture (aarch64 for Apple Silicon): https://github.com/docker/compose/releases/latest

Copy the executable to /usr/local/bin, naming it docker-compose.

From there, make sure it's executable:

Copysudo chmod +x docker-compose

Clear Apple's scareware:

Copysudo xattr -d com.apple.quarantine docker-compose

As in the Homebrew case, add

Copy "cliPluginsExtraDirs": [
     "/opt/homebrew/lib/docker/cli-plugins"
 ]

to your ~/.docker/config.json file.

Open a new terminal session and try

Copydocker compose version

If that doesn't work, try

Copydocker-compose version

If that works, the cliPluginsExtraDirs entry in the config.json file isn't working.

🌐
DEV Community
dev.to › mochafreddo › running-docker-on-macos-without-docker-desktop-64o
Running Docker on macOS Without Docker Desktop: Alternatives, Limitations, and Best Practices - DEV Community
February 14, 2025 - If you choose to bypass Docker Desktop—for instance, by using Colima or similar alternatives—the official documentation implies that you need to manually install the additional tools (like docker-compose and docker-credential-helper).
Discussions

How to install docker-engine in macOS without docker desktop? - Unix & Linux Stack Exchange
I don't need any of the features ... Docker Desktop®. I have used docker in a laptop with debian on it and that version is good enough for me. Is there a way to install the linux version of docker in macOS? I need both the engine and the cli tool, nothing more. I run build commands, push, tag, run, docker-compose, ... More on unix.stackexchange.com
🌐 unix.stackexchange.com
Docker for Mac Without Docker Desktop
Why not just use Docker Desktop? Am I out of the loop? What am I missing? More on reddit.com
🌐 r/docker
33
23
January 28, 2022
[MacOS] Can I get away with just docker CLI and Docker-compose CLI?
Just to note, you should use Docker Compose, not docker-compose More on reddit.com
🌐 r/docker
11
4
July 22, 2024
macos - docker-compose command not available for mac - Stack Overflow
I ran into the same issue on macOS today. Turned out that you need to run the installed app once, it does some additional downloading and setup. That setup includes setting up your path variables. ... This combined with the first answer worked for me. The command is docker compose instead of docker-compose 2024-07-30T01:08:24.547Z+00:00 ... Restart the docker desktop ... More on stackoverflow.com
🌐 stackoverflow.com
🌐
OneUptime
oneuptime.com › home › blog › how to install docker engine without docker desktop on macos
How to Install Docker Engine Without Docker Desktop on macOS
February 8, 2026 - Colima is the most popular Docker Desktop alternative on macOS. It runs a lightweight Linux VM using Lima and configures Docker inside it automatically. The entire setup takes one command. # Install Colima and the Docker CLI using Homebrew brew install colima docker docker-compose docker-buildx
🌐
Alvin
alvin.codes › snippets › docker-compose-macos-no-desktop
Docker Compose on macOS without the app - Alvin Bryan
So, we want the docker and docker compose commands but not the Docker desktop app. It’s possible thanks to an open-source daemon/client named colima. That’s what we’ll run here.
🌐
swyx
swyx.io › running-docker-without-docker-desktop
Running Docker without Docker Desktop
May 27, 2022 - Docker Desktop sucks. Here's my fix. brew install qemu docker colima (colima replaces the docker/dockerd binary, qemu helps you unable to resize disk for v big images) Install the right docker-compose binary for your chipset from the releases page · sudo curl -L https://github.com/docker/compose/releases/download/v2.5.1/docker-compose-darwin-aarch64 -o /usr/local/bin/docker-compose for M1 Macs...
🌐
1Gbits
1gbits.com › home page › blog › server software & tools › how to install docker on mac: a complete step-by-step guide
How to Install Docker on Mac: A Complete Step-by-Step Guide
May 3, 2026 - No Desktop. If you prefer a manual installation, follow these steps: ... This method installs Docker CLI without requiring Homebrew. Honestly, skip this unless you're integrating with a custom virtualization stack. The Docker daemon doesn't run natively on macOS — it always runs inside a Linux VM. Compose ...
Find elsewhere
🌐
DataCamp
datacamp.com › tutorial › install-docker-compose
How to Install Docker Compose: Linux, macOS, and Windows | DataCamp
February 20, 2026 - If you prefer managing tools with Homebrew and don't want the full Docker Desktop GUI, you can install Docker and Compose through it: ... If you go this route, remember that Homebrew installs Docker Engine without the Desktop app. This works fine for CLI use, but you'll miss features like the Docker Dashboard and automatic updates. For most macOS users, Docker Desktop is the easier path.
🌐
DEV Community
dev.to › swyx › running-docker-without-docker-desktop-339h
Running Docker without Docker Desktop - DEV Community
May 27, 2022 - Install the right docker-compose binary for your chipset from the releases page · sudo curl -L https://github.com/docker/compose/releases/download/v2.5.1/docker-compose-darwin-aarch64 -o /usr/local/bin/docker-compose for M1 Macs · chmod +x ...
🌐
Aitor Alonso
aalonso.dev › blog › 2024 › how-to-use-docker-engine-without-docker-desktop-macos-colima
How to use docker engine without Docker Desktop on macOS with Colima · Aitor Alonso
January 25, 2025 - Anyway, after you start the VM ... use docker-compose or the compose command in docker, we need to install it separately and link it as a CLI addon for docker....
🌐
DEV Community
dev.to › elliotalexander › how-to-use-docker-without-docker-desktop-on-macos-217m
How to use Docker without Docker Desktop on MacOS 📦 - DEV Community
October 29, 2022 - Unfortunately this is not a viable solution, because Docker Compose will be missing. There's no apparent way to install it manually on Mac, either.
🌐
GitHub
gist.github.com › malteos › 7b3e5b4a64408c1d4d216ba756b9b995
Run Docker (without Docker Desktop) on MacOS with Apple Silicon (M1/M2/...) · GitHub
Docker Desktop requires an expensive license for commercial use: https://www.docker.com/pricing/faq/ # Install minikube brew install minikube # Install Docker CLI brew install docker brew install docker-compose # hyperkit is not available for mac m1/m2.
🌐
Docker Docs
docs.docker.com › manuals › docker compose › overview of installing docker compose
Overview of installing Docker Compose | Docker Docs
May 28, 2026 - Learn how to install Docker Compose. Compose is available natively on Docker Desktop, as a Docker Engine plugin, and as a standalone tool.
🌐
GitHub
github.com › abiosoft › colima › discussions › 874
How do I make `docker compose` work when using colima? · abiosoft/colima · Discussion #874
I was in the same situation recently, so just a guess -- you use Homebrew to install docker-compose. ... mkdir -p ~/.docker/cli-plugins ln -sfn $HOMEBREW_PREFIX/opt/docker-compose/bin/docker-compose ~/.docker/cli-plugins/docker-compose
Author   abiosoft
🌐
Reddit
reddit.com › r/docker › [macos] can i get away with just docker cli and docker-compose cli?
r/docker on Reddit: [MacOS] Can I get away with just docker CLI and Docker-compose CLI?
July 22, 2024 -

Hello everyone,

I am a long-time Windows user, but I am finally making the switch to a MacBook Pro M1 Pro for development. I tried switching a year ago but couldn't make the transition at that time. For my daily tasks, I need to use Docker.

I believe that I can accomplish what I need with just the Docker CLI and Docker Compose CLI. However, since I am not very familiar with the macOS ecosystem, there might be some options I am overlooking.

Here is what I need:

  • Build and run Docker containers

  • Orchestration via Docker Compose

  • ARM native support

  • Kubernetes would be nice, but it's not a requirement

On Windows, I have been using Docker Desktop. Since I am transitioning to a completely new ecosystem, I wanted to explore the available options. Here is what I have found:

  • Podman

  • Rancher Desktop

  • Colima

  • Orbstack

  • And of course, Docker Desktop

I prefer CLI tools for the most part, as long as they are robust and easy to use. While I am not opposed to GUIs, I spend most of my time in the terminal. As long as the software is well-built, fast, and does not consume excessive resources, I am fine.

Any input or advice you might have would be greatly appreciated.

Thanks a lot!

🌐
Nicholas Clooney
blog.nicholas.clooney.io › posts › docker-on-macOS-with-colima
Running Docker on macOS Without Docker Desktop: My Journey With Colima · Nicholas Clooney
October 2, 2025 - Like a lot of developers coming ... Mac. On Linux, you just install Docker and it works natively. On macOS, it’s a bit different — there’s no native Docker Engine because we don’t have a Linux kernel. That’s where tools like Docker Desktop and Colima come ...