Rozul Imam
IT Web Programmer

Cara Install Docker Compose Secara Manual di Linux

Docker Compose adalah tool untuk menjalankan multi-container Docker menggunakan file docker-compose.yml.
Meskipun sekarang Docker Compose sudah terintegrasi sebagai plugin (docker compose),
dalam beberapa kondisi seperti server minimal, environment offline, atau kebutuhan versi tertentu,
kita perlu melakukan instalasi secara manual.


1. Pastikan Docker Sudah Terinstall

Sebelum menginstall Docker Compose, pastikan Docker sudah tersedia di sistem.

docker --version

Jika belum terinstall, silakan install Docker terlebih dahulu sesuai sistem operasi yang digunakan.


2. Cek Arsitektur Sistem

Docker Compose memiliki binary berbeda tergantung arsitektur sistem (x86_64, aarch64, dll).

uname -m

Contoh output umum:

  • x86_64
  • aarch64

3. Download Binary Docker Compose

Download langsung dari rilis resmi GitHub.

Install versi terbaru (x86_64)

sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

Install versi tertentu (contoh: v2.27.0)

sudo curl -L https://github.com/docker/compose/releases/download/v2.27.0/docker-compose-linux-x86_64 -o /usr/local/bin/docker-compose

4. Berikan Permission Eksekusi

Setelah file terdownload, ubah permission agar bisa dieksekusi:

sudo chmod +x /usr/local/bin/docker-compose

5. Verifikasi Instalasi

Cek apakah instalasi berhasil:

docker-compose --version

Jika berhasil, akan muncul output seperti:

Docker Compose version v2.x.x

Alternatif (Direkomendasikan): Install sebagai Docker CLI Plugin

Versi terbaru Docker Compose menggunakan format plugin CLI (docker compose, tanpa tanda minus).

mkdir -p ~/.docker/cli-plugins/
curl -SL https://github.com/docker/compose/releases/latest/download/docker-compose-linux-x86_64 -o ~/.docker/cli-plugins/docker-compose
chmod +x ~/.docker/cli-plugins/docker-compose

Verifikasi:

docker compose version

Perbedaan docker-compose vs docker compose

docker-compose docker compose
Binary standalone CLI plugin
Versi lama Versi modern
Menggunakan tanda minus Tanpa tanda minus
Mulai deprecated Direkomendasikan

Tips Keamanan

  • Download hanya dari repository resmi GitHub.
  • Verifikasi checksum SHA256 jika digunakan di production.
  • Pastikan hanya user tertentu yang memiliki hak write ke file binary.
  • Gunakan user non-root untuk menjalankan container jika memungkinkan.

Kesimpulan

Instalasi Docker Compose secara manual cocok untuk:

  • Server minimal tanpa repository tambahan
  • Environment offline
  • Kebutuhan versi tertentu
  • Sistem yang tidak mendukung plugin otomatis

Untuk deployment modern, lebih disarankan menggunakan docker compose (plugin resmi)
karena lebih future-proof dan mengikuti standar terbaru Docker.