Panduan Langkah demi Langkah: Deploy Grav CMS di VPS Linux, macOS, & Windows dengan Stack Docker LAMP

Panduan langkah demi langkah untuk menyiapkan dan mengintegrasikan Grav CMS menggunakan docker-lamp-grav di VPS Linux, macOS, dan Windows.

Selamat datang di panduan lengkap ini! Pada tutorial ini, kita akan membahas langkah demi langkah cara mengoperasikan Grav CMS menggunakan repositori open-source resmi milkboyinchina/docker-lamp-grav di VPS Linux, macOS, dan Windows.

Baik Anda ingin mengoperasikan server produksi cloud, komputer pengembangan macOS, maupun laptop Windows, mengemas stack LAMP Anda dengan Docker memastikan lingkungan runtime yang konsisten dan deployment yang cepat.

Langkah 1: Persyaratan Sistem & Persiapan

Sebelum memulai deployment kontainer, pastikan lingkungan Anda memenuhi spesifikasi minimum:

• VPS Linux: Ubuntu 22.04 LTS / 24.04 LTS atau Debian 12 (Minimal 1 vCPU, 1 GB RAM, 15 GB SSD storage). Port firewall 22 (SSH), 80 (HTTP), dan 443 (HTTPS) terbuka.
• macOS: macOS Monterey (12.0) atau lebih baru (Apple Silicon M1/M2/M3 atau Intel).
• Windows: Windows 10 64-bit (Build 19044+) atau Windows 11 dengan fitur WSL2 aktif.

Langkah 2: Menginstal Docker Engine (Linux, macOS, & Windows)

🐧 Server Linux (Ubuntu / Debian)

Jalankan skrip resmi untuk memasang Docker CE dan plugin Docker Compose:

# Perbarui paket & instal engine Docker
sudo apt update && sudo apt upgrade -y
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
sudo systemctl enable --now docker

🍏 macOS (Intel & Apple Silicon M1/M2/M3)

1. Unduh Docker Desktop for Mac melalui docker.com/products/docker-desktop.
2. Pilih Mac with Apple Silicon (M1/M2/M3) atau Mac with Intel chip.
3. Buka berkas .dmg lalu seret Docker.app ke folder Applications.
4. Jalankan Docker Desktop dari Applications dan verifikasi di Terminal:

   docker --version
   docker compose version

🪟 Windows 10 / 11 (WSL2 & PowerShell)

1. Aktifkan WSL2 (Windows Subsystem for Linux) dengan menjalankan PowerShell sebagai Administrator:

   wsl --install

2. Unduh Docker Desktop for Windows melalui docker.com/products/docker-desktop.
3. Jalankan installer dan pastikan opsi Use WSL 2 instead of Hyper-V tercentang.
4. Restart komputer Anda, buka Docker Desktop, dan verifikasi di PowerShell atau WSL2:

   docker --version
   docker compose version

Langkah 3: Meng-clone Repositori Docker-LAMP-Grav

Selanjutnya, clone repositori milkboyinchina/docker-lamp-grav ke perangkat Anda:

# Clone repositori ke direktori kerja
git clone https://github.com/milkboyinchina/docker-lamp-grav.git docker-lamp-grav

# Masuk ke folder proyek
cd docker-lamp-grav

Struktur repositori mencakup konfigurasi kontainer untuk:

• Apache 2.4 dengan mod_rewrite aktif untuk routing URL Grav.
• PHP 8.3 FPM teroptimasi dengan OPcache dan ekstensi utama (gd, zip, mbstring, curl, xml).
• Grav CMS Core dengan manajemen izin file otomatis.

Fleksibilitas: Menjalankan Aplikasi PHP Lain (WordPress, Laravel, Drupal)

Meskipun stack ini telah dikonfigurasi awal untuk Grav CMS, arsitektur dasar Apache 2.4 + PHP 8.3 FPM + Docker Compose pada docker-lamp-grav menjadikannya fondasi yang sangat fleksibel untuk berbagai aplikasi dan framework PHP populer lainnya:

• WordPress: Cukup tempatkan berkas WordPress ke dalam direktori src/, tambahkan layanan MariaDB/MySQL pada docker-compose.yml, lalu jalankan wizard instalasi WordPress.
• Laravel: Tempatkan proyek Laravel Anda di dalam src/, atur DocumentRoot Apache ke src/public, dan jalankan migrasi Artisan dari dalam kontainer.
• Drupal & Symfony: Ekstensi PHP 8.3 yang telah dioptimalkan (gd, mbstring, zip, xml, opcache) memberikan kompatibilitas penuh untuk proyek Drupal, Symfony, maupun CodeIgniter.

Langkah 4: Konfigurasi Lingkungan & Izin File

Salin file contoh konfigurasi lingkungan dan atur izin hak akses file:

# Salin konfigurasi lingkungan contoh
cp .env.example .env

# Sesuaikan kepemilikan file untuk pengguna web server (www-data) pada Linux/macOS
sudo chown -R 33:33 src/user src/logs src/cache

Langkah 5: Menjalankan Kontainer & Mengakses Grav CMS

Jalankan stack kontainer dalam mode latar belakang (-d):

# Jalankan stack Docker LAMP Grav
docker compose up -d --build

Periksa status kontainer yang berjalan:

docker compose ps

Menyelesaikan Pengaturan di Browser

1. Buka browser web Anda dan akses alamat IP server atau localhost: http://localhost/ atau http://IP_SERVER_ANDA/
2. Anda akan disambut oleh Layar Pendaftaran Admin Grav CMS.
3. Buat akun admin utama (username, email, dan kata sandi).
4. Masuk ke Panel Admin Grav untuk mulai membuat konten dan mempublikasikan artikel!