Docker Compose installeren: Linux, macOS en Windows

Draait Docker bij jou en ken je de basiscommando’s, maar ben je het zat om containers één voor één te starten?

Docker Compose is een tool waarmee je multi-containerapplicaties kunt definiëren en draaien vanuit één YAML-bestand. Het verwarrende is dat er twee versies rondzwerven: de oude, zelfstandige binary (v1) en de nieuwere CLI-plugin (v2). De meeste installatiehandleidingen vertellen je niet welke ze gebruiken, waardoor je stappen volgt die niet bij jouw setup passen.

Docker Compose v2 is een plugin die bij moderne Docker-installaties wordt meegeleverd, wat het installeren, draaien en verifiëren een stuk eenvoudiger maakt. Het proces is niet meer zo handmatig als vroeger.

In dit artikel laat ik je stap voor stap zien hoe je Docker Compose op Linux, macOS en Windows installeert — op de juiste manier, met v2.

Nieuw met virtualisatie en containerisatie? Lees ons recente Docker voor beginners-artikel voor hands-on ervaring.

Voordat je Docker Compose installeert

Allereerst heb je Docker Engine op je machine nodig. Docker Compose draait niet op zichzelf — het heeft Docker nodig om te werken.

Voer dit commando uit om je Docker-versie te controleren:

docker --versionMogelijk gemaakt door

Geïnstalleerde Docker-versie

Als Docker niet is geïnstalleerd, stop dan hier en installeer het eerst. Als het wel is geïnstalleerd, kun je controleren of Compose al beschikbaar is:

docker compose versionMogelijk gemaakt door

Geïnstalleerde Docker Compose-versie

Als dat een versienummer teruggeeft, ben je klaar — Compose v2 zit al bij je Docker-installatie. Je kunt direct naar de verificatiesectie gaan.

Als je in plaats daarvan een generieke melding krijgt dat het commando niet is gevonden, lees dan verder.

Hier is het belangrijkste onderscheid dat je moet kennen:

• Docker Compose v1 is de verouderde zelfstandige binary. Je riep die aan met docker-compose (met een koppelteken). Deze is afgeschreven en wordt niet meer onderhouden.

• Docker Compose v2 is een CLI-plugin die met moderne Docker wordt meegeleverd. Je roept die aan met docker compose (zonder koppelteken).

Als je een recente Docker-installatie hebt, heb je vrijwel zeker al v2. De rest van dit artikel gaat uit van v2.

Docker Compose installeren op Linux

Op Linux heb je twee manieren om Docker Compose te krijgen. De eerste gebruikt Docker’s officiële repository — dit is de aanbevolen route. De tweede is een handmatige installatie, handig als je geen pakketbeheerder kunt gebruiken of een specifieke versie nodig hebt.

Methode 1: Via Docker’s officiële repository (aanbevolen)

Met deze methode blijft Compose gekoppeld aan je Docker-installatie, zodat updates in sync blijven.

Als je Docker Engine nog niet hebt geïnstalleerd, stel dan eerst Docker’s officiële apt-repository in:

# Add Docker's GPG key
sudo apt-get update
sudo apt-get install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

# Add the repository
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

sudo apt-get updateMogelijk gemaakt door

Installeer nu Docker Engine en de Compose-plugin samen:

sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-pluginMogelijk gemaakt door

Het pakket docker-compose-plugin zorgt ervoor dat je docker compose als CLI-commando hebt. Verifieer dat het werkt:

docker compose versionMogelijk gemaakt door

Docker Compose-versie op Ubuntu-VM

Dat is alles.

Methode 2: Handmatige installatie (standalone binary)

Gebruik deze methode als je een specifieke versie van Compose nodig hebt of als je omgeving Docker’s repository niet ondersteunt.

Begin met het downloaden van de nieuwste release rechtstreeks van GitHub. Vervang v5.0.1 door de versie die je nodig hebt:

DOCKER_CONFIG=${DOCKER_CONFIG:-$HOME/.docker}
mkdir -p $DOCKER_CONFIG/cli-plugins
curl -SL https://github.com/docker/compose/releases/download/v5.0.1/docker-compose-linux-x86_64 -o $DOCKER_CONFIG/cli-plugins/docker-composeMogelijk gemaakt door

Maak de binary uitvoerbaar:

chmod +x $DOCKER_CONFIG/cli-plugins/docker-composeMogelijk gemaakt door

En controleer tot slot de installatie:

docker compose versionMogelijk gemaakt door

Docker Compose-versie op Ubuntu-VM

Onthoud wel dat handmatige installaties niet automatisch updaten. Als je een binary installeert en er niet meer naar omkijkt, kun je uiteindelijk een verouderde versie draaien met bekende bugs of beveiligingsproblemen. Ga je deze route, kijk dan af en toe op de Docker Compose-releasespagina.

Docker Compose installeren op macOS

Op macOS hoef je Docker Compose niet apart te installeren — het wordt meegeleverd met Docker Desktop.

Download Docker Desktop via de officiële site van Docker. Let erop dat je de juiste versie voor je chip kiest — Apple Silicon (M1–M5) of Intel.

Open na de installatie Docker Desktop en laat het volledig opstarten. Controleer daarna of Compose beschikbaar is met dit commando:

docker compose versionMogelijk gemaakt door

Docker Compose-versie op macOS

Dat is alles. Compose v2 is klaar voor gebruik.

Optioneel: Installeren via Homebrew

Als je tools liever met Homebrew beheert en de volledige Docker Desktop-GUI niet wilt, kun je Docker en Compose hiermee installeren:

brew install docker
brew install docker-composeMogelijk gemaakt door

Onthoud bij deze route dat Homebrew Docker Engine installeert zonder de Desktop-app. Dat werkt prima voor CLI-gebruik, maar je mist functies zoals het Docker Dashboard en automatische updates. Voor de meeste macOS-gebruikers is Docker Desktop de makkelijkere weg.

Docker Compose installeren op Windows

Net als op macOS krijgt Windows Docker Compose automatisch via Docker Desktop. Er is geen aparte installatie nodig.

Voordat je Docker Desktop installeert, moet WSL2 (Windows Subsystem for Linux 2) zijn ingeschakeld. WSL2 laat Docker een echte Linux-kernel op Windows draaien — zo werken containers op dit platform. Schakel het in door PowerShell als Administrator te openen en uit te voeren:

wsl --installMogelijk gemaakt door

Herstart je machine wanneer hierom wordt gevraagd. Download en installeer daarna Docker Desktop via de officiële site van Docker.

Zorg er tijdens de setup voor dat de optie "Use WSL2 instead of Hyper-V" is aangevinkt. Zodra Docker Desktop draait, controleer je of Compose beschikbaar is — dit kan zowel in PowerShell als in je WSL-terminal:

docker compose versionMogelijk gemaakt door

Veelvoorkomende permissieproblemen

Krijg je een "permission denied"-fout, dan zijn er meestal twee mogelijkheden:

• Docker Desktop draait niet. Het moet actief zijn in het systeemvak voordat docker-commando’s werken.
• Je gebruiker zit niet in de juiste groep. Zorg er in WSL voor dat je Linux-gebruiker toegang heeft tot de Docker-socket. Je lost dit op door je WSL-terminal als Administrator uit te voeren of door je gebruiker toe te voegen aan de docker-groep binnen WSL:

sudo usermod -aG docker $USERMogelijk gemaakt door

Log nu uit en weer in bij WSL om de wijziging door te voeren.

Installatie van Docker Compose verifiëren

Zodra je Docker Compose hebt geïnstalleerd, voer je dit commando uit om te bevestigen dat alles werkt:

docker compose versionMogelijk gemaakt door

Je zou uitvoer als deze moeten zien:

Geïnstalleerde Compose-versie

Het exacte versienummer verschilt afhankelijk van het moment van lezen, maar zolang je v5.0.1 of nieuwer ziet, zit je goed.

Als je docker compose: command not found ziet, is Compose niet geïnstalleerd of staat het niet op je PATH. Ga naar de probleemoplossingssectie hieronder.

docker compose vs docker-compose

Je ziet online misschien artikelen die docker-compose met een koppelteken gebruiken. Dit is het verschil:

• docker-compose is het legacy v1-commando. Het was een zelfstandige Python-binary die los van Docker werd geïnstalleerd.

• docker compose (zonder koppelteken) is de v2 CLI-plugin, direct ingebouwd in de Docker-CLI.

Docker heeft de ondersteuning voor v1 in 2023 laten vallen, dus docker-compose wordt niet meer onderhouden. Als je het nog hebt geïnstalleerd, kun je controleren waarnaar het verwijst:

docker-compose --versionMogelijk gemaakt door

Als dat een 1.x.x-versie teruggeeft, draai je de oude binary. Verwijder die en gebruik voortaan docker compose. De commando’s zijn vrijwel identiek, maar v2 is sneller en wordt actief onderhouden.

Docker Compose upgraden

Hoe je Compose upgradet, hangt af van hoe je het hebt geïnstalleerd.

Op macOS en Windows regelt Docker Desktop alles voor je, dus open de app, ga naar Settings > Software Updates en laat zo nodig updaten. Compose wordt automatisch samen met Docker geüpgraded.

Op Linux met de pakketbeheerder voer je het volgende uit:

sudo apt-get update
sudo apt-get upgrade docker-compose-pluginMogelijk gemaakt door

Dat haalt de nieuwste versie uit Docker’s officiële repository.

Als je handmatig hebt geïnstalleerd, moet je de downloadstap herhalen met het nieuwe versienummer. Bekijk de Docker Compose-releasespagina voor de nieuwste versie en vervang vervolgens de binary:

curl -SL https://github.com/docker/compose/releases/download/v5.0.2/docker-compose-linux-x86_64 -o $DOCKER_CONFIG/cli-plugins/docker-compose
chmod +x $DOCKER_CONFIG/cli-plugins/docker-composeMogelijk gemaakt door

Controleer na elke upgrade even of de nieuwe versie actief is:

docker compose versionMogelijk gemaakt door

Meer is er niet voor nodig.

Docker Compose verwijderen

De verwijderstappen hangen af van hoe je Compose in eerste instantie hebt geïnstalleerd.

Als je via de pakketbeheerder op Linux hebt geïnstalleerd, verwijder je de plugin met dit commando:

sudo apt-get remove docker-compose-pluginMogelijk gemaakt door

Als je handmatig hebt geïnstalleerd, verwijder je gewoon de binary:

rm $DOCKER_CONFIG/cli-plugins/docker-composeMogelijk gemaakt door

Als je de oude v1-standalone binary nog op je systeem hebt, vind en verwijder die dan met dit commando:

sudo rm /usr/local/bin/docker-composeMogelijk gemaakt door

Controleer na het verwijderen even of het weg is door docker compose version uit te voeren. Als het commando een fout teruggeeft, is de de-installatie geslaagd.

Veelvoorkomende installatieproblemen

Docker Compose installeren en verwijderen is eenvoudig, maar er kan altijd iets misgaan. Zo los je mogelijke problemen op waar je tegenaan kunt lopen.

"docker compose: command not found"

Dit betekent ofwel dat Compose niet is geïnstalleerd, of dat Docker het niet kan vinden. Controleer eerst of Docker zelf draait:

docker --versionMogelijk gemaakt door

Als Docker in orde is maar Compose ontbreekt, installeer de plugin dan opnieuw:

sudo apt-get install docker-compose-pluginMogelijk gemaakt door

Permission denied-fouten

Krijg je een permission denied-fout bij het uitvoeren van docker compose, dan heeft je gebruiker waarschijnlijk geen toegang tot de Docker-socket. Voeg jezelf toe aan de docker-groep:

sudo usermod -aG docker $USERMogelijk gemaakt door

Log uit en weer in zodat de wijziging effect heeft. Op Docker Desktop (macOS/Windows) moet je er bovendien voor zorgen dat de app daadwerkelijk draait voordat je commando’s probeert.

Versieconflict

Als Compose zich onverwacht gedraagt, controleer dan welke versie je daadwerkelijk draait:

docker compose versionMogelijk gemaakt door

Als je op een oude versie zit, volg dan de upgrade-stappen uit de eerdere sectie. Als je zowel v1 als v2 hebt geïnstalleerd, is dat waarschijnlijk de bron van de verwarring.

Conflicten tussen v1 en v2

Zowel docker-compose (v1) als docker compose (v2) op dezelfde machine kan conflicten veroorzaken. Controleer of v1 nog aanwezig is met dit commando:

which docker-composeMogelijk gemaakt door

Als dat een pad teruggeeft, verwijder het dan:

sudo rm $(which docker-compose)Mogelijk gemaakt door

Gebruik voortaan docker compose (zonder koppelteken).

PATH-problemen

Als Docker is geïnstalleerd maar commando’s niet worden gevonden, staat de CLI-plugindirectory mogelijk niet op je PATH. Controleer waar de Compose-binary staat:

ls $DOCKER_CONFIG/cli-plugins/Mogelijk gemaakt door

Als hij daar staat maar niet werkt, voeg de directory dan toe aan je PATH in ~/.bashrc of ~/.zshrc:

export PATH=$PATH:$HOME/.docker/cli-pluginsMogelijk gemaakt door

Herlaad daarna je shell met:

source ~/.bashrcMogelijk gemaakt door

Docker Compose v1 vs. v2

Als je al een tijdje met Docker werkt, heb je waarschijnlijk zowel docker-compose als docker compose in online artikelen en video’s gezien. Het zijn niet dezelfde dingen.

Docker Compose v1 was een zelfstandige Python-binary die je los van Docker installeerde. Het gebruikte het docker-compose-commando (met een koppelteken). Docker heeft het in 2023 afgeschreven; het wordt niet meer onderhouden of geüpdatet.

Docker Compose v2 is een Go-gebaseerde CLI-plugin, direct ingebouwd in de Docker-CLI. Je roept het aan met docker compose (zonder koppelteken). Het wordt meegeleverd met Docker Engine en Docker Desktop, dus op moderne setups hoef je niets extra’s te installeren.

De commando-syntaxis is vrijwel identiek tussen beide versies — de meeste docker-compose-commando’s werken hetzelfde met docker compose. Het belangrijkste verschil zit onder de motorkap: v2 is sneller, beter geïntegreerd met Docker’s tooling en wordt actief onderhouden.

Hier is een vergelijking:

Vergelijkingstabel van Compose v1 en v2

In 2026 blijf je bij v2. Als je scripts of CI-pijplijnen nog docker-compose gebruiken, vervang dan het koppelteken door een spatie — dat is voor de meeste workflows de enige wijziging die je nodig hebt.

Conclusie

Als je een moderne Docker-installatie draait, heb je Compose v2 al. Er zijn geen extra stappen nodig. Op macOS en Windows wordt Compose meegeleverd met de Docker Desktop-applicatie. Gebruik je Linux, dan wordt het geregeld door het docker-compose-plugin-pakket.

Voordat je Compose-bestanden gaat schrijven of draaien, voer docker compose version uit om te bevestigen dat alles klaarstaat.

Als je nog Compose v1 draait, is dit het moment om te switchen. Laat het koppelteken vallen en verwijder de oude binary — dat is alles. Al je bestaande Compose-bestanden werken ongewijzigd met v2.

Op zoek naar meer bronnen over Docker? Schrijf je in voor onze Introductie tot Docker-cursus en leer over containers, images en meer.