Promo Domain .biz.id hanya Rp2.500 Cek domain →
JowHost
Self-Hosting

Tutorial Docker Compose untuk Pemula: Contoh Nyata WordPress + MariaDB di VPS

Tutorial Docker Compose untuk pemula dengan contoh nyata WordPress + MariaDB: compose.yaml, .env, volume, update image, reboot, dan pesan error yang umum.

Zulfianto 7 menit baca
Terminal berisi docker compose up untuk WordPress dan MariaDB dengan status healthy
Daftar isi
  1. Apa itu Docker Compose? (sebelum mulai tutorial)
  2. Langkah 1: siapkan folder dan file .env
  3. Langkah 2: tulis compose.yaml
  4. Langkah 3: periksa sebelum menjalankan
  5. Langkah 4: jalankan
  6. Perintah sehari-hari
  7. Container saling memanggil lewat nama service
  8. Data aman di volume: down vs down -v
  9. Update image: jebakan khusus WordPress
  10. Setelah server di-reboot
  11. Port 80, firewall, dan banyak aplikasi
  12. Pesan error dan peringatan yang sering muncul
  13. Berapa RAM dan disk yang dipakai?
  14. Jalur cepat

Tutorial Docker Compose ini tidak memakai contoh "hello world". Kita langsung menjalankan WordPress + database MariaDB di VPS, lalu membuktikan hal-hal yang biasanya hanya disebut sekilas: data di volume tetap aman setelah down, apa yang terjadi saat server di-reboot, dan kenapa mengganti versi image WordPress tidak meng-update WordPress Anda.

Diuji 6 November 2026 di Super Cloud Regular 1 vCPU · 2 GB, Ubuntu 24.04.5 LTS, Docker 29.9.3, Docker Compose v5.7.0, WordPress 7.1 (image -apache), MariaDB 11.8. Semua keluaran di bawah adalah hasil asli dari server uji.

Apa itu Docker Compose? (sebelum mulai tutorial)

Docker Compose membaca satu file, compose.yaml, yang berisi daftar container beserta setelannya: image, variabel, volume, port, dan urutan menyala. Tanpa Compose, menjalankan WordPress berarti membuat jaringan, dua volume, dan dua perintah docker run panjang dengan urutan yang harus diingat. Dengan Compose, semuanya cukup docker compose up -d, dan file-nya bisa disimpan, dibaca ulang, atau dipindah ke server lain.

Compose sekarang adalah plugin Docker, jadi perintahnya docker compose (dengan spasi). Perintah lama docker-compose (dengan tanda hubung) tidak ikut terpasang:

$ docker-compose version
bash: line 2: docker-compose: command not found
$ docker compose version
Docker Compose version v5.7.0

Kalau Docker belum terpasang, ikuti dulu Install Docker di Ubuntu 24.04. Plugin Compose ikut terpasang dari paket docker-compose-plugin.

Langkah 1: siapkan folder dan file .env

Satu aplikasi, satu folder. Nama folder juga menjadi nama project Compose, dan dipakai sebagai awalan nama volume dan jaringan.

sudo mkdir -p /opt/wordpress && cd /opt/wordpress
sudo tee .env > /dev/null <<EOF
WP_VERSION=7.1.3
DB_PASSWORD=$(openssl rand -hex 16)
DB_ROOT_PASSWORD=$(openssl rand -hex 16)
EOF
sudo chmod 600 .env

File .env menyimpan nilai yang berbeda per server (password, versi). Compose membacanya otomatis dari folder yang sama, sehingga compose.yaml tidak perlu berisi password.

Langkah 2: tulis compose.yaml

services:
  db:
    image: mariadb:11.8
    restart: unless-stopped
    environment:
      MARIADB_DATABASE: wordpress
      MARIADB_USER: wordpress
      MARIADB_PASSWORD: ${DB_PASSWORD}
      MARIADB_ROOT_PASSWORD: ${DB_ROOT_PASSWORD}
    volumes:
      - db_data:/var/lib/mysql
    healthcheck:
      test: ["CMD", "healthcheck.sh", "--connect", "--innodb_initialized"]
      interval: 10s
      timeout: 5s
      retries: 5

  wordpress:
    image: wordpress:${WP_VERSION}-apache
    restart: unless-stopped
    depends_on:
      db:
        condition: service_healthy
    ports:
      - "80:80"
    environment:
      WORDPRESS_DB_HOST: db
      WORDPRESS_DB_USER: wordpress
      WORDPRESS_DB_PASSWORD: ${DB_PASSWORD}
      WORDPRESS_DB_NAME: wordpress
    volumes:
      - wp_data:/var/www/html

volumes:
  db_data:
  wp_data:

Arti tiap bagian:

Kunci Fungsinya
services Daftar container. Nama service (db, wordpress) sekaligus menjadi nama host di jaringan internal.
image Image dan versinya. Tulis versi yang jelas, bukan latest, agar tidak berubah diam-diam.
restart: unless-stopped Container dinyalakan lagi otomatis setelah error atau reboot, kecuali Anda sendiri yang menghentikannya.
environment Variabel untuk aplikasi. ${DB_PASSWORD} diambil dari file .env.
volumes Folder data yang disimpan di luar container, sehingga tidak hilang saat container dibuat ulang.
healthcheck Cara memeriksa apakah MariaDB benar-benar siap menerima koneksi.
depends_on + service_healthy WordPress baru dijalankan setelah db dinyatakan sehat.
ports Membuka port container ke internet: "PORT-SERVER:PORT-CONTAINER".

Langkah 3: periksa sebelum menjalankan

docker compose config -q && echo "config valid"

Tanpa -q, perintah ini menampilkan isi compose.yaml setelah variabel dari .env dimasukkan. Berguna untuk memastikan variabel terbaca, tapi password ikut tampil, jadi jangan menempelkan hasilnya di forum.

Langkah 4: jalankan

docker compose up -d
docker compose ps

Di server uji, up -d pertama kali selesai dalam 62 detik, termasuk mengunduh kedua image. Urutannya terlihat jelas di keluaran: WordPress baru dijalankan setelah database sehat.

 Container wordpress-db-1 Started
 Container wordpress-db-1 Healthy
 Container wordpress-wordpress-1 Starting
 Container wordpress-wordpress-1 Started
SERVICE     STATUS                    PORTS
db          Up 21 seconds (healthy)   3306/tcp
wordpress   Up Less than a second     0.0.0.0:80->80/tcp, [::]:80->80/tcp

Kolom PORTS menunjukkan db hanya bisa dihubungi dari dalam jaringan Docker (3306/tcp tanpa panah), sedangkan wordpress terbuka di port 80. Beberapa detik kemudian, http://IP-VPS/ mengalihkan ke /wp-admin/install.php, yaitu halaman instalasi WordPress.

Perintah sehari-hari

Perintah Kegunaan
docker compose ps Status container di project ini
docker compose logs -f --tail 50 wordpress Melihat log (Ctrl+C untuk berhenti)
docker compose exec db mariadb -u wordpress -p wordpress Masuk ke dalam container, misalnya membuka konsol database
docker compose stop / start Menghentikan/menyalakan tanpa menghapus container
docker compose restart wordpress Menyalakan ulang satu service
docker compose down Menghapus container dan jaringan; volume tetap ada
docker compose pull lalu up -d Mengambil image versi baru lalu membuat ulang container yang berubah
docker compose ls Daftar semua project Compose di server

Semua perintah dijalankan dari folder yang berisi compose.yaml. Kalau tidak, Compose menolak dengan pesan no configuration file provided: not found.

Container saling memanggil lewat nama service

Perhatikan WORDPRESS_DB_HOST: db. Compose membuat jaringan khusus untuk project ini (wordpress_default), dan di dalamnya setiap service bisa dipanggil dengan namanya:

$ docker compose exec wordpress getent hosts db
172.18.0.2      db

Alamat IP di dalam jaringan bisa berubah setiap container dibuat ulang, tetapi nama db selalu benar. Karena itu database tidak perlu dan sebaiknya tidak dibuka ke internet dengan ports:.

Data aman di volume: down vs down -v

Setelah WordPress kami instal (judul situs "Belajar Compose"), kami mencoba tiga hal:

  1. docker compose stop: kedua container berstatus Exited (0) tetapi masih ada. docker compose start menyalakannya lagi.
  2. docker compose down: container dan jaringan dihapus, tetapi volume wordpress_db_data dan wordpress_wp_data tetap ada. Setelah docker compose up -d, situs kembali dalam 14 detik dengan judul dan isi yang sama.
  3. docker compose down -v: opsi -v ikut menghapus volume.
 Volume wordpress_wp_data Removed
 Volume wordpress_db_data Removed

Setelah up -d lagi, WordPress kembali ke halaman instalasi: semua isi situs hilang. Jangan pernah memakai down -v untuk aplikasi yang datanya penting.

Update image: jebakan khusus WordPress

Untuk meng-update, ubah versi di .env, lalu ambil image baru dan buat ulang container:

sudo sed -i "s/^WP_VERSION=.*/WP_VERSION=7.1.4/" .env
docker compose pull
docker compose up -d

pull di server uji memakan 33 detik. Compose hanya membuat ulang container yang image-nya berubah. Kalau tidak ada yang berubah, keluarannya hanya Running.

Lalu kami cek versi WordPress yang benar-benar berjalan:

WordPress di volume (yang dipakai situs) : 7.1.3
WordPress di dalam image baru            : 7.1.4

Image WordPress hanya menyalin file WordPress ke volume saat volume masih kosong. Setelah itu, mengganti versi image hanya meng-update Apache dan PHP, bukan WordPress-nya. Core WordPress, tema, dan plugin tetap di-update dari Dasbor → Pembaruan di wp-admin seperti biasa. Banyak image lain berbeda; untuk n8n misalnya, ganti versi image memang meng-update aplikasinya (lihat Update n8n di Docker). Baca dokumentasi image yang Anda pakai.

Setelah server di-reboot

Kami me-reboot VPS untuk menguji restart: unless-stopped. Hasilnya:

  • 18 detik setelah perintah reboot, situs sudah merespons, tetapi menampilkan "Database Error".
  • Beberapa detik kemudian situs normal kembali dengan sendirinya.

Penyebabnya terlihat di docker inspect: kedua container dinyalakan bersamaan (08:12:04.000 dan 08:12:04.013), dengan selisih 13 milidetik. Setelah reboot, yang menyalakan container adalah Docker sendiri, bukan docker compose up, sehingga depends_on dan healthcheck tidak dipakai untuk mengatur urutan. WordPress sempat menyala sebelum MariaDB siap.

Untuk WordPress ini tidak masalah karena WordPress mencoba koneksi lagi di setiap request. Aplikasi yang langsung berhenti kalau database belum siap tetap akan dinyalakan ulang terus oleh restart: unless-stopped sampai berhasil. Jadi restart: tetap wajib ada.

Port 80, firewall, dan banyak aplikasi

Dua hal yang perlu diketahui sebelum membuka port dengan ports::

  • Port yang dibuka Docker melewati UFW. Aturan ufw deny tidak berlaku untuk port container. Detail dan cara mengatasinya ada di Docker bypass UFW. Untuk layanan yang hanya dipakai sendiri, tulis "127.0.0.1:8080:80" agar hanya bisa dibuka dari server itu.
  • Satu port hanya untuk satu container. Saat port 80 sudah dipakai WordPress, container lain yang meminta port 80 ditolak:
Bind for 0.0.0.0:80 failed: port is already allocated

Untuk menjalankan beberapa aplikasi di port 80/443 dengan domain berbeda, pasang reverse proxy di depannya. Perbandingan tiga pilihan populer, lengkap dengan hasil uji, ada di Nginx Proxy Manager vs Caddy vs Traefik.

Pesan error dan peringatan yang sering muncul

Semua pesan ini kami munculkan sendiri di server uji:

  • Atribut version: di baris pertama (dari tutorial lama):

    the attribute `version` is obsolete, it will be ignored, please remove it to avoid potential confusion
    

    Hanya peringatan. Hapus baris version:.

  • Indentasi YAML salah (spasi kurang satu):

    go-yaml load error in parser (while parsing a block mapping) at L2.C3-L4.C4: did not find expected key
    

    Angka L4 menunjuk baris yang bermasalah. Gunakan spasi, bukan Tab, dengan kelipatan yang konsisten.

  • Variabel .env belum diisi atau salah ketik nama:

    The "DB_PASSWORD" variable is not set. Defaulting to a blank string.
    

    Compose tetap jalan dengan nilai kosong, dan database bisa terbuat tanpa password. Selalu jalankan docker compose config -q dulu.

  • WordPress tidak bisa mengirim email. Log container berisi sh: 1: /usr/sbin/sendmail: not found. Image WordPress tidak membawa program pengirim email, jadi pasang plugin SMTP untuk email reset password dan notifikasi.

Berapa RAM dan disk yang dipakai?

Saat diam setelah instalasi, container WordPress memakai 91 MiB dan MariaDB 100 MiB. Seluruh server (Ubuntu + Docker + kedua container) memakai 564 MB dari 1,9 GB. Image-nya yang besar: wordpress:7.1.4-apache 1,12 GB dan mariadb:11.8 458 MB. Setiap kali update, image lama tetap tersimpan sampai Anda menghapusnya dengan docker image prune -a.

Jalur cepat

Untuk mencoba tanpa menulis file, saat memesan Super Cloud tersedia aplikasi one-click Docker dan WordPress. Super Cloud juga bisa dibayar per jam dari saldo, cocok untuk latihan: server uji artikel ini dihapus setelah selesai, dan tagihan berhenti saat server dihapus.

Self-Hosting

Ditulis oleh

Zulfianto

Digital Marketing Konsultan & Server Specialist.

Artikel lainnya