Tutorial Cara Install & Setup Docker Compose V2 di Linux, macOS, dan Windows

Apa Itu Docker Compose?

Docker Compose adalah tools untuk menjalankan dan mengelola beberapa container sekaligus menggunakan satu file konfigurasi (docker-compose.yml).

Dengan Compose, Anda bisa:

• Menjalankan aplikasi multi-service (misalnya: backend + database + cache)

• Mengatur dependency antar container

• CI/CD pipeline testing

• Microservices architecture

• Menjalankan environment development hanya dengan satu command

Contoh command:

docker compose up -d

Sejak 2023, Docker Compose v1 sudah deprecated, dan saat ini standar yang digunakan adalah: docker compose versi v2 → CLI plugin, recommended.

---

Beda Docker Compose v1 vs v2

Kesimpulan:
Gunakan Docker Compose v2 di semua environment modern.

---

Prasyarat Sebelum Install

Sebelum menginstal Docker Compose, pastikan:

1. Docker sudah terinstall

Cek dengan:

docker --version

2. Cek apakah Compose sudah tersedia

docker compose version

Jika muncul versi → tidak perlu install lagi
Jika muncul error → lanjut ke instalasi

---

Cara Install Docker Compose di Linux

Di Linux, ada dua metode:

Method 1 (Direkomendasikan): Via Repository Resmi Docker

Metode ini paling stabil dan mudah di-maintain.

Step 1: Tambahkan Repository Docker

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

Tambahkan 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 update

Step 2: Install Docker + Compose Plugin

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

Step 3: Verifikasi

docker compose version

Jika berhasil, akan muncul versi Compose.

---

Method 2: Install Manual (Binary)

Gunakan jika:

• Tidak bisa pakai package manager

• Butuh versi spesifik

Step 1: Download Binary

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-compose

 

Step 2: Beri Permission

chmod +x $DOCKER_CONFIG/cli-plugins/docker-compose

Step 3: Verifikasi installation 

docker compose version

Noted:

• Tidak auto-update

• Harus update manual jika ada versi baru

---

Cara Install Docker Compose di macOS

Cara Paling Mudah Gunakan Docker Desktop

Di macOS, Docker Compose sudah include dalam Docker Desktop.

Step:

1. Download Docker Desktop (pilih sesuai chip: Intel / Apple Silicon) 

2. Install seperti biasa

3. Jalankan aplikasi

4. Tunggu sampai Docker aktif 

5. Verifikasi:

docker compose version

---

Optional: Install via Homebrew

Jika tidak ingin GUI:

brew install docker
brew install docker-compose

⚠️Kekurangan:

• Tidak ada dashboard

• Tidak ada auto-update GUI

• Setup lebih manual

---

Cara Install Docker Compose di Windows

Gunakan Docker Desktop (Wajib untuk Windows)

Step 1: Aktifkan WSL2

Jalankan di PowerShell (Admin):

wsl --install

Restart komputer setelah selesai.

---

Step 2: Install Docker Desktop

• Download dari situs resmi

• Saat install, pilih: "Use WSL2 instead of Hyper-V" 

---

Step 3: Verifikasi

docker compose version

Bisa dijalankan di:

• PowerShell

• CMD

• WSL Terminal

---

❌ Troubleshooting di Windows

Error: Permission Denied

Solusi:

sudo usermod -aG docker $USER

Lalu restart session WSL.

---

Docker tidak jalan

Pastikan:

• Docker Desktop aktif

• Icon muncul di system tray

---

Verifikasi Instalasi Docker Compose  (Semua OS)

Gunakan command ini:

docker compose version

Contoh output:

---

Upgrade Docker Compose

Linux

sudo apt-get update

sudo apt-get upgrade docker-compose-plugin

---

macOS & Windows

Update via Docker Desktop:

Settings → Software Update

---

Manual Install

Download ulang versi terbaru dan replace 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-compose

---

Uninstall Docker Compose

Linux (Package Manager)

sudo apt-get remove docker-compose-plugin

Manual Install

rm $DOCKER_CONFIG/cli-plugins/docker-compose

Hapus Compose v1

sudo rm /usr/local/bin/docker-compose

---

Common Installation Issues

1. "docker compose: command not found"

Solusi:

sudo apt-get install docker-compose-plugin

 

2. Permission Denied errors

sudo usermod -aG docker $USER

Logout → login ulang

3. Konflik v1 dan v2

Cek:

which docker-compose

Hapus jika ada:

sudo rm $(which docker-compose)

4. PATH Error

Cek:

ls $DOCKER_CONFIG/cli-plugins/

Tambahkan:

export PATH=$PATH:$HOME/.docker/cli-plugins

Reload:

source ~/.bashrc

---

Best Practice untuk Profesional IT

Agar setup stabil dan production-ready:

1. Selalu gunakan Docker Compose v2 saja

2. Hindari install manual jika tidak perlu

3. Integrasikan dengan CI/CD (GitLab CI, GitHub Actions)

4. Gunakan Docker Desktop untuk dev environment

5. Gunakan package manager untuk production server

6. Gunakan .env untuk konfigurasi sensitif

7. Jangan campur v1 dan v2 dalam satu sistem

---

Ringkasan:

• Linux: gunakan docker-compose-plugin

• macOS: cukup install Docker Desktop

• Windows: wajib Docker Desktop + WSL2

• Command utama: docker compose (tanpa hyphen)

Dengan setup yang benar, Anda bisa:

• Menjalankan microservices dengan mudah

• Meningkatkan produktivitas DevOps

• Mengelola environment secara konsisten

---

FAQ:

1. Apa perbedaan docker-compose dan docker compose?
docker-compose adalah versi lama (v1), sedangkan docker compose adalah versi terbaru (v2) yang terintegrasi dengan Docker CLI.

2. Apakah Docker Compose perlu diinstall terpisah?
Tidak selalu. Di Docker Desktop (macOS & Windows), Compose sudah otomatis tersedia.

3. Kenapa docker compose tidak dikenali?
Biasanya karena plugin belum terinstall atau PATH belum benar.

4. Apakah Docker Compose masih relevan di 2026?
Sangat relevan, terutama untuk development dan orchestration skala kecil hingga menengah.

5. Apakah Compose bisa digunakan di production?
Bisa, tetapi untuk skala besar biasanya digantikan oleh Kubernetes.

---

Siap deploy aplikasi multi-container tanpa ribet?

Upgrade skill DevOps Anda dan pelajari lebih advanced terkait Docker, Docker Compose, Container dan Kubernetes dengan mengikuti pelatihan intensif di SUHU.

Berikut pelatihan yang kami rekomendasikan:

• Docker and Kubernetes Basic to Advance

• Building Architecture Application Using Microservices

• GitLab Administration & GitLab CI/CD

• FastAPI Python dan Implementasi di CI/CD

Silakan konsultasikan kebutuhan Anda bersama kami dengan klik link berikut: https://bit.ly/kontaksuhu