Cara Install Docker dan Docker Compose di Ubuntu

Kalau kamu memasang Docker dengan apt install docker.io, perintah docker compose bisa tidak tersedia atau versinya tertinggal dari tutorial yang kamu ikuti. Penyebabnya, ada dua sumber paket Docker di Ubuntu: paket dari repositori Ubuntu sendiri dan paket dari repositori resmi Docker. Dokumentasi Docker menyarankan repositori resminya, yang sekaligus membawa plugin Compose versi baru. Langkah di bawah mengikuti dokumentasi resmi tersebut per 4 November 2026. Versi Ubuntu yang didukung menurut halaman itu: 22.04 LTS, 24.04 LTS, 26.04 LTS, dan 26.10, untuk arsitektur 64-bit. Turunan seperti Linux Mint tidak didukung resmi.

Belum terlalu paham konsep image dan container? Baca dulu apa itu Docker.

Langkah instalasi

Berikut perintah untuk setiap langkah.

1. Hapus paket yang bentrok

sudo apt remove $(dpkg --get-selections docker.io docker-compose docker-compose-v2 docker-doc docker-buildx podman-docker containerd runc | cut -f1)

Image, container, dan volume lama di /var/lib/docker/ tidak ikut terhapus oleh perintah ini.

2. Tambahkan kunci GPG

sudo apt update
sudo apt 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

3. Tambahkan repositori

sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF

sudo apt update

Bagian Suites otomatis terisi kode nama versi Ubuntu-mu, jadi perintah yang sama bisa dipakai di semua versi yang didukung.

4. Pasang paket

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

Paket terakhir, docker-compose-plugin, yang menyediakan perintah docker compose (dengan spasi). Perintah lama docker-compose (dengan tanda hubung) adalah program terpisah dan tidak dipasang di sini.

5. Uji

sudo systemctl status docker
sudo docker run hello-world
docker compose version

Bila hello-world mencetak pesan sambutan, Docker Engine sudah berjalan. Di Ubuntu dan Debian, layanan Docker otomatis aktif saat boot.

Pengaturan setelah instalasi

Menjalankan docker tanpa sudo

Tambahkan user ke grup docker:

sudo groupadd docker
sudo usermod -aG docker $USER
newgrp docker

Logout lalu login lagi agar keanggotaan grup berlaku di semua sesi.

Membatasi ukuran log

Driver log bawaan, json-file, menyimpan log container di host dan terus membesar. Buat atau edit /etc/docker/daemon.json:

{
  "log-driver": "local"
}

Driver local merotasi log secara default. Muat ulang dengan sudo systemctl restart docker. Pengaturan ini hanya berlaku untuk container yang dibuat setelahnya.

Perhatikan firewall

Dokumentasi Docker juga mencatat bahwa port container yang dipublikasikan melewati aturan ufw dan firewalld. Jadi jangan mengandalkan UFW untuk menutup port container. Publikasikan port ke 127.0.0.1 untuk layanan internal. Ini salah satu poin di kesalahan umum Docker di produksi.

Menjalankan stack compose pertama

Buat folder proyek dan file compose.yaml:

mkdir ~/web-contoh && cd ~/web-contoh

Isi compose.yaml:

services:
  web:
    image: nginx:1.30
    restart: unless-stopped
    ports:
      - "127.0.0.1:8080:80"
    volumes:
      - ./html:/usr/share/nginx/html:ro

Tag nginx:1.30 hanya contoh versi yang dikunci. Ganti dengan versi yang sesuai kebutuhanmu, asal bukan latest. Buat halaman sederhana lalu jalankan:

mkdir html && echo "Halo dari Docker" > html/index.html
docker compose up -d
docker compose ps
curl http://127.0.0.1:8080

Perintah sehari-hari yang perlu kamu ingat:

• docker compose logs -f: melihat log.
• docker compose down: menghentikan dan menghapus container (volume tetap ada).
• docker compose pull && docker compose up -d: memperbarui image lalu menjalankan ulang.

Port sengaja diikat ke 127.0.0.1. Untuk membukanya ke publik dengan HTTPS, letakkan reverse proxy di depannya, seperti di cara pasang Caddy sebagai reverse proxy.

Error yang sering muncul

Checklist

• Paket Docker tidak resmi sudah dihapus
• Repositori resmi Docker dan kuncinya terpasang
• docker run hello-world dan docker compose version berhasil
• User pengelola masuk grup docker, tidak lebih
• Driver log dibatasi di daemon.json
• Port layanan internal diikat ke 127.0.0.1