Instalasi dan Konfigurasi OctoberCMS pada Lingkungan ServBay

Gambaran Umum

OctoberCMS adalah sistem manajemen konten (CMS) open-source yang dibangun di atas framework Laravel yang kuat. CMS ini populer berkat kesederhanaan, fleksibilitas, dan kemudahan penggunaannya bagi para pengembang. Dokumen ini bertujuan membimbing Anda untuk menginstal dan mengonfigurasi OctoberCMS di ServBay—solusi pengembangan web satu atap yang dirancang untuk macOS—agar Anda dapat segera memulai proyek berbasis OctoberCMS.

Apa itu OctoberCMS?

OctoberCMS menyediakan antarmuka backend yang intuitif dan kemampuan pengembangan frontend yang mumpuni, memungkinkan pengembang menggunakan konsep Laravel yang sudah dikenal (seperti Eloquent ORM, Blade template engine, dan lainnya) untuk membangun beragam jenis website, mulai dari blog sederhana hingga aplikasi perusahaan yang kompleks.

Prasyarat

Sebelum memulai instalasi OctoberCMS, pastikan Anda telah memenuhi syarat berikut:

1. ServBay sudah diinstal dan dijalankan pada sistem macOS Anda.
2. Paket PHP (direkomendasikan versi 7.4 ke atas) dan MySQL/MariaDB sudah diaktifkan serta berjalan di ServBay.
3. Paket Composer sudah diaktifkan di ServBay.
4. Memahami dasar-dasar penggunaan perintah pada terminal/command line.

Langkah-langkah Instalasi OctoberCMS

Berikut adalah langkah-langkah lengkap untuk menginstal dan mengonfigurasi OctoberCMS di lingkungan ServBay:

Langkah 1: Membuat Direktori Proyek

Pertama, navigasi ke direktori root website yang direkomendasikan oleh ServBay, yaitu /Applications/ServBay/www, lalu buat direktori baru untuk proyek OctoberCMS Anda.

cd /Applications/ServBay/www
mkdir servbay-octobercms-app
cd servbay-octobercms-app

Langkah 2: Instalasi OctoberCMS Menggunakan Composer

ServBay sudah menyertakan dan mengonfigurasi Composer. Pastikan paket Composer aktif dari panel kontrol ServBay. Sekarang, jalankan perintah Composer berikut di direktori proyek yang baru saja dibuat untuk mengunduh dan menginstal file inti OctoberCMS:

composer create-project october/october .

Perintah ini akan mengunduh versi terbaru OctoberCMS dari repositori resmi ke direktori saat ini (.).

Langkah 3: Membuat Database dan Pengguna

OctoberCMS memerlukan database untuk menyimpan konten, pengguna, pengaturan, dan informasi lainnya. Kita akan menggunakan phpMyAdmin bawaan ServBay untuk membuat database serta pengguna baru.

1. Akses phpMyAdmin Bawaan ServBay

   Buka browser lalu akses panel pengembangan lokal ServBay di https://servbay.host/. Klik atau navigasi ke tautan phpMyAdmin yang disediakan, biasanya https://servbay.host/phpmyadmin/, untuk masuk ke alat manajemen basis data.

2. Buat Pengguna Database

   Demi keamanan dan keterpisahan, sebaiknya buat user dan database terpisah untuk setiap aplikasi.

   1. Masuk ke Halaman Akun Pengguna

      Dari halaman utama phpMyAdmin, klik menu atas “User Accounts” (Akun Pengguna).

   2. Tambah Pengguna Baru

      Klik “Add user account” (Tambah Akun Pengguna). Isi informasinya:

      • Username: Masukkan nama pengguna untuk koneksi OctoberCMS ke database, misal october_user.
      • Host Name: Pilih localhost atau 127.0.0.1 agar user hanya bisa mengakses database secara lokal, meningkatkan keamanan.
      • Password: Masukkan kata sandi yang kuat dan unik. Jangan gunakan contoh password password123 di lingkungan produksi.
      • Re-type: Ulangi password yang Anda buat.
      • Pada bagian “Database for user”, pilih opsi “Create database with same name and grant all privileges” (Buat database dengan nama yang sama dan beri semua hak akses). Ini akan membuat database october_user dan memberikan akses penuh pada user tersebut.
      • Pastikan centang “Grant all privileges” di bagian “Global privileges” (Jika sudah memilih pembuatan database otomatis, langkah ini biasanya sudah dilakukan).
      • Klik tombol “Go”/“Execute” di bagian bawah halaman untuk menyelesaikan proses pembuatan user dan database.

Langkah 4: Konfigurasi Server Web (Tambah Website di ServBay)

Agar bisa mengakses aplikasi OctoberCMS melalui browser, Anda perlu mengonfigurasi situs lokal baru di ServBay.

1. Tambahkan Website Baru

   Buka panel kontrol ServBay, lalu klik tab “Website” di side-bar kiri (catatan: pada versi lama bisa tertulis “Hosts”). Klik tombol “Add Website”.

   Isi detail berikut:

   • Name/Nama: Berikan nama yang gampang dikenali, misal My OctoberCMS Site.
   • Domain: Masukkan domain lokal yang ingin digunakan, misal servbay-octobercms.local. Gunakan akhiran .local untuk menghindari konflik dengan domain nyata.
   • Tipe Website: Pilih PHP.
   • Versi PHP: Pilih versi PHP yang ingin digunakan oleh OctoberCMS, pastikan sesuai dengan versi aktif di ServBay dan memenuhi syarat OctoberCMS.
   • Root Directory: Klik tombol browse dan pilih direktori proyek yang Anda buat di langkah 1, yaitu /Applications/ServBay/www/servbay-octobercms-app.

2. Simpan Konfigurasi & Restart ServBay

   Setelah semua terisi, klik tombol simpan. ServBay akan meminta untuk menerapkan perubahan, biasanya butuh restart pada software terkait (seperti Caddy atau Nginx) dan ServBay itu sendiri. Lakukan sesuai petunjuk sampai perubahan aktif. ServBay otomatis mengarahkan domain servbay-octobercms.local ke lokal (127.0.0.1).

Langkah 5: Konfigurasi Environment Variable OctoberCMS

OctoberCMS (berbasis Laravel) menggunakan file .env untuk mengelola environment variable aplikasi—termasuk pengaturan koneksi database dan kunci aplikasi.

1. Salin File Contoh Konfigurasi Environment

   Dari root proyek OctoberCMS (/Applications/ServBay/www/servbay-octobercms-app), salin file .env.example lalu ubah namanya menjadi .env:

   cd /Applications/ServBay/www/servbay-octobercms-app
   cp .env.example .env

2. Edit File .env

   Bukalah file .env menggunakan editor teks favorit. Temukan bagian pengaturan database dan sesuaikan dengan rincian database yang telah Anda buat sebelumnya:

   # ... pengaturan lain ...
   
   DB_CONNECTION=mysql
   DB_HOST=127.0.0.1
   DB_PORT=3306
   DB_DATABASE=october_user  # Ganti dengan nama database Anda
   DB_USERNAME=october_user  # Ganti dengan username database Anda
   DB_PASSWORD=password123   # Ganti dengan password yang Anda buat
   
   # ... pengaturan lain ...

   Penting: Pastikan nilai DB_DATABASE, DB_USERNAME, dan DB_PASSWORD telah sesuai dengan yang Anda gunakan pada Langkah 3.

Langkah 6: Menjalankan Installer OctoberCMS

OctoberCMS menyediakan wizard instalasi berbasis web untuk penyelesaian setup dan migrasi database serta pembuatan akun admin.

1. Akses Halaman Instalasi

   Buka browser dan kunjungi domain lokal yang diatur pada Langkah 4, ditambah /install.php, misalnya:

   https://servbay-octobercms.local/install.php

   Anda seharusnya melihat wizard instalasi OctoberCMS.

2. Isi Data Koneksi Database

   Wizard akan meminta Anda mengisi info koneksi database. Gunakan detail yang sama dengan di file .env:

   • Tipe Database: MySQL
   • Host Database: localhost atau 127.0.0.1
   • Nama Database: october_user
   • Username Database: october_user
   • Password Database: password123

   (Sekali lagi, gunakan password aktual Anda)

3. Isi Data Admin

   Lanjutkan dengan mengisi info akun admin yang diinginkan untuk login ke backend OctoberCMS, seperti username, password, dan email.

4. Selesaikan Instalasi

   Klik tombol “Install” atau sesuai instruksi pada wizard. Proses ini akan melakukan migrasi database, membuat kunci aplikasi, dan pengaturan lain. Tunggu hingga selesai.

Langkah 7: Instal Plugin dan Tema (Opsional)

Setelah instalasi, Anda dapat login ke backend OctoberCMS di https://servbay-octobercms.local/backend.

1. Instal Plugin

   Dari backend, navigasi ke menu “System” -> “Updates” -> “Plugins”. Anda bisa mencari dan memasang berbagai plugin dari OctoberCMS Marketplace untuk memperluas fungsionalitas.

2. Instal Tema

   Pergi ke “System” -> “Updates” -> “Themes” untuk menjelajah dan memasang tema yang sesuai kebutuhan proyek.

Konfigurasi dan Penggunaan Dasar Setelah Instalasi

Setelah instalasi sukses, Anda dapat mulai membangun website. Berikut beberapa langkah awal yang sering dilakukan:

• Akses Halaman Depan: Buka domain lokal Anda https://servbay-octobercms.local/ untuk menampilkan homepage (biasanya menggunakan tema default).
• Akses Backend: Kunjungi https://servbay-octobercms.local/backend lalu login dengan akun admin yang telah Anda buat.
• Membuat Halaman: Di backend, buka menu “CMS” -> “Pages” untuk membuat serta mengedit halaman situs.
• Membuat Konten Reusable: Navigasi ke “CMS” -> “Content” untuk membuat konten yang dapat digunakan ulang.
• Konfigurasi Tema: Atur tema aktif, layout, partials, dan parameter lain di “CMS” -> “Themes”.
• Kelola User dan Hak Akses: Atur pengguna backend dan hak akses mereka pada “System” -> “Manage”.

FAQ (Pertanyaan Umum)

• Tanya: Saat mengakses servbay-octobercms.local hanya muncul halaman default ServBay atau error?
  • Jawab: Pastikan website servbay-octobercms.local telah berhasil ditambahkan di panel ServBay dan root direktori telah diatur ke /Applications/ServBay/www/servbay-octobercms-app. Setelah menambah atau mengubah website, restart ServBay agar perubahan aktif. Pastikan layanan Caddy/Nginx dan PHP berjalan.
• Tanya: Membuka https://servbay-octobercms.local/install.php muncul halaman kosong atau error?
  • Jawab: Biasanya ini adalah error PHP. Lihat log error PHP di panel ServBay. Penyebab umum: masalah permission file (pastikan folder storage, themes, dan plugins serta subfoldernya dapat ditulis user web server), versi PHP tak kompatibel, atau ekstensi PHP yang belum terinstal.
• Tanya: Muncul error koneksi database saat instalasi?
  • Jawab: Periksa detail database pada file .env (DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD) sudah benar sesuai pengaturan dan pembuatan database pada phpMyAdmin. Pastikan layanan MySQL/MariaDB aktif di ServBay.
• Tanya: Kenapa perintah composer create-project gagal?
  • Jawab: Pastikan Composer dan PHP telah diaktifkan di panel ServBay, serta versi PHP sudah sesuai. Pastikan juga koneksi internet stabil karena Composer harus mengunduh file.

Kesimpulan

Dengan lingkungan terpadu yang ditawarkan ServBay, Anda bisa menginstal dan mengonfigurasi OctoberCMS di macOS secara cepat dan mudah. Ikuti langkah dalam panduan ini untuk membangun platform pengembangan web lokal yang powerful dan ramah developer untuk proyek Anda berikutnya. Kini, saatnya menjelajahi fitur OctoberCMS dan membangun website keren Anda!