Panduan Lengkap Instalasi CMS Grav di Localhost untuk Pemula

Photo by Christina @ wocintechchat.com on Unsplash

Mau coba Grav CMS tapi bingung mulai dari mana? Tenang kamu tidak perlu langsung sewa hosting atau pusing mengatur server. Kali ini kita akan bahas cara instal Grav CMS di localhost alias komputer kamu sendiri. Dengan ini kamu bisa belajar mengelola website tanpa risiko dan gratis! Yuk simak langkah demi langkahnya.

Kenapa Instal Grav CMS di Localhost?

• Belajar Tanpa Risiko: Salah di setting? Tinggal hapus folder dan ulang dari awal.
• Cepat Tanpa Internet: Akses website langsung dari komputer tanpa bergantung pada koneksi.
• Eksperimen Bebas: Coba tema plugin atau fitur baru tanpa khawatir merusak website live.

Persiapan Sebelum Instalasi

1. Download Software yang Dibutuhkan

Kamu perlu dua tools utama:

• XAMPP (untuk server lokal): Download di sini
• Grav CMS Package: Download versi terbaru

Pastikan XAMPP sudah terinstall di komputer. Pilih versi sesuai sistem operasi (Windows/macOS/Linux).

2. Aktifkan Apache dan MySQL di XAMPP

1. Buka XAMPP Control Panel
2. Klik Start di sebelah Apache dan MySQL
3. Tunggu sampai status berubah menjadi hijau

3. Buat Folder Project

Buka folder htdocs di direktori XAMPP (biasanya di C:\xampp\htdocs untuk Windows atau /Applications/XAMPP/htdocs di macOS). Buat folder baru dengan nama grav-project.

Langkah 1: Ekstrak File Grav CMS

1. Buka file ZIP Grav yang sudah didownload
2. Salin semua isi folder ke dalam grav-project
3. Pastikan struktur folder menjadi:

grav-project/

├── assets/

├── bin/

├── system/

└── ...

Langkah 2: Jalankan Grav CMS di Browser

1. Buka browser favoritmu
2. Ketik http://localhost/grav-project di address bar
3. Tekan Enter

Jika berhasil kamu akan melihat halaman default Grav CMS.

Langkah 3: Aktifkan Grav Admin Panel (Opsional)

Grav CMS punya admin panel untuk memudahkan pengelolaan konten. Cara installnya:

1. Buka terminal atau command prompt
2. Masuk ke folder grav-project
3. Jalankan perintah:

title: Post Pertama

Selamat Datang di Blog Pertamaku!

Ini adalah konten pertamaku menggunakan Grav CMS.

5. Simpan file dan refresh browser

Akses http://localhost/grav-project/blog/post-pertama untuk melihat hasilnya.

Troubleshooting Umum

Error "PHP Version Not Supported"

Pastikan PHP versi 7.3 atau lebih baru aktif di XAMPP. Cek dengan cara:

1. Buka XAMPP Control Panel
2. Klik Config di sebelah Apache
3. Pilih PHP (php.ini)
4. Cari php_version di bagian atas

Halaman Tidak Muncul

1. Pastikan folder grav-project ada di dalam htdocs
2. Cek apakah Apache di XAMPP sudah running
3. Restart XAMPP dan coba lagi

Gagal Install Admin Panel

Jika muncul error saat install admin panel:

1. Pastikan kamu sudah masuk ke folder project via terminal
2. Update Composer dengan perintah composer self-update
3. Jalankan php bin/grav clearcache sebelum instal ulang

Tips Optimasi Grav di Localhost

Gunakan Tema Simpel

Pilih tema ringan seperti Quark (bawaan Grav) untuk mempercepat proses development.

Aktifkan Debug Mode

Tambahkan kode ini di user/config/system.yaml:
debugger:

enabled: true

Ini membantumu melacak error selama development.

Backup Rutin

Salin folder grav-project secara berkala ke cloud atau flashdisk. Jika ada error tinggal ganti dengan folder backup.

Cara Update Grav CMS di Localhost

1. Buka terminal di folder project
2. Jalankan php bin/gpm selfupgrade
3. Tunggu sampai proses selesai
4. Clear cache dengan php bin/grav clearcache

Alternatif XAMPP untuk macOS/Linux

• MAMP (macOS): https://www.mamp.info
• Docker: Paket image Grav CMS siap pakai
• Laragon (Windows): Lebih ringan dari XAMPP

FAQ Instalasi Grav CMS

Apa Bisa Pakai PHP 8?

Bisa! Grav CMS mendukung PHP 8.1 ke atas. Pastikan XAMPP/MAMP-mu sudah terupdate.

Bagaimana Cara Mengubah Port Localhost?

Jika port 80 sibuk:

1. Buka XAMPP > Apache Config > httpd.conf
2. Cari Listen 80 ganti jadi Listen 8080
3. Akses via http://localhost:8080/grav-project

File .md Tidak Terbaca?

Pastikan kamu:

• Menyimpan file dengan ekstensi .md
• Menggunakan format YAML header yang benar
• Tidak ada typo di nama file

Langkah Selanjutnya Setelah Instalasi

1. Coba Theme

Jelajahi Grav Themes Directory dan coba instal tema baru.

2. Tambahkan Plugin

Beberapa plugin wajib dicoba:

• Grav Sitemap: Buat peta situs otomatis
• Grav Forms: Tambahkan formulir kontak
• Grav SEO: Optimasi untuk mesin pencari

3. Pelajari Markdown

Karena konten Grav CMS berbasis Markdown kuasai sintaks dasarnya seperti:

Heading 1

Tebal

Miring

Link

Kesimpulan

Instalasi Grav CMS di localhost ternyata mudah kan? Dalam 30 menit kamu sudah bisa punya website lengkap di komputer sendiri. Gunakan ini untuk belajar eksperimen atau persiapan sebelum deploy ke hosting. Kalau ada error jangan panik cek lagi step-stepnya atau cari solusi di forum Grav. Selamat mencoba!