Website Madrasah (Webma) adalah CMS berbasis CodeIgniter 4 yang saya buat khusus untuk kebutuhan sekolah/madrasah. Agar website bisa diakses online dengan domain sekolah/madrasah, maka Webma perlu dipasang di hosting.

Berikut langkah demi langkah instalasi Webma ke hosting cPanel.

1. Persiapan Sebelum Upload

Pastikan Anda sudah memiliki:

• File CMS Webma (hasil download/zip).
• File db_webma .sql
• Akun cPanel hosting dan akses domain/subdomain.
• Hosting dengan support PHP 8.1 atau lebih.

2. Membuat Database di Hosting

• Masuk ke cPanel → MySQL® Databases.
• Buat database baru → misal madrasah_db.
• Buat user database → misal madrasah_user + password.
• Hubungkan user ke database dengan All Privileges.
• Buka phpMyAdmin → pilih database → Import → unggah file db_webma.sql.

3. Upload File Webma

Ada dua cara:

Opsi A (disarankan): Document root ke public/

• Upload file Webma ke home directory (misal /home/username/webma).
• Extract file zip.
• Ubah document root domain/subdomain menjadi …/webma/public.

Opsi B (jika document root tidak bisa diubah):

• Upload file Webma ke home directory (misal /home/username/webma).
• Extract file zip.
• Pindahkan isi folder public/ ke dalam public_html/.
• Edit file index.php di public_html/ → arahkan ke ../webma/app/Config/Paths.php.

4. Konfigurasi File .env

• Pastikan ada file .env di folder Webma.
• Buka .env, lalu ubah pengaturan berikut

CI_ENVIRONMENT = production
app.baseURL = 'https://namadomainmadrasah.sch.id/'
app.appTimezone = Asia/Jakarta
database.default.hostname = localhost
database.default.database = madrasah_db
database.default.username = madrasah_user
database.default.password = passwordAnda
database.default.DBDriver = MySQLi
encryption.key = base64:ISI_KUNCI

Untuk encryption.key, gunakan hasil dari perintah:

php spark key:generate

atau gunakan kunci bawaan Webma.

5. Atur File .htaccess

Pastikan file .htaccess bawaan Webma/CodeIgniter 4 ada di root public/ atau public_html/.

Jika Webma dipasang di subfolder, tambahkan:

RewriteBase /namafolder/

6. Set Permission Folder

Agar Webma bisa berjalan normal, pastikan folder berikut memiliki izin tulis (755 atau 775):

/writable
/writable/cache
/writable/logs
/writable/session
/writable/uploads

7. Selesai & Uji Coba

Buka domain Anda: https://namadomainmadrasah.sch.id/

Jika tampilan website muncul, instalasi berhasil.

Jika error:

• 500 Internal Server Error → cek versi PHP (harus 8.1+).
• Database error → cek username/password DB di .env.
• CSS/JS tidak muncul → pastikan baseURL sudah benar.

Tips Tambahan

• Gunakan Subdomain untuk memisahkan layanan (misal: ortu.domain.sch.id, cbt.domain.sch.id).
• Jangan taruh file .env, folder app, vendor di dalam public_html.
• Selalu gunakan <?= base_url('assets/...') ?>  saat memanggil file CSS/JS/gambar.

Dengan mengikuti langkah di atas, CMS Webma yang sudah Anda instal di lokal kini bisa berjalan di hosting dan diakses secara online melalui domain/sekolah Anda.