Panduan Instalasi Mandiri (Self-Hosted)

Terakhir diperbarui: 23 Mei 2026

Panduan ini akan membimbing Anda langkah demi langkah untuk menginstal WargaKas di server web Anda (Shared Hosting cPanel, CyberPanel, atau VPS). WargaKas dirancang agar sangat mudah dipasang bahkan jika Anda tidak memiliki latar belakang IT mendalam.

Butuh Bantuan Instalasi Gratis?

Jika organisasi Anda membeli lisensi resmi WargaKas, tim dukungan teknis kami siap memasang aplikasi ini ke cPanel hosting Anda tanpa biaya tambahan. Silakan hubungi kami melalui WhatsApp Support atau email ke contact@fihla.id.

Prasyarat Sistem (System Requirements)

Sebelum memulai, pastikan hosting atau server Anda telah memenuhi spesifikasi minimum berikut:

Web Server: Apache, Nginx, atau LiteSpeed Web Server.
Versi PHP: PHP 8.1 atau 8.2 (sangat direkomendasikan PHP 8.1).
Ekstensi PHP: pdo_mysql, mbstring, openssl, curl, zip, xml, dan gd.
Database: MySQL 5.7+ atau MariaDB 10.3+.
Domain/Subdomain: Sebuah domain aktif yang dilengkapi sertifikat SSL (HTTPS) gratis (seperti Let's Encrypt).

Unggah Berkas Aplikasi WargaKas

Unduh berkas instalasi wargakas.zip dari email konfirmasi pembelian Anda, kemudian ikuti langkah berikut:

Masuk ke control panel hosting Anda (misal: cPanel).
Buka menu File Manager dan navigasikan ke direktori domain/subdomain Anda (biasanya di public_html untuk domain utama, atau folder khusus untuk subdomain Anda).
Klik tombol Upload di toolbar atas, pilih file wargakas.zip, dan tunggu hingga proses unggah selesai 100%.
Kembali ke File Manager, klik kanan pada file wargakas.zip yang telah diunggah, lalu pilih Extract.

Buat Database & User MySQL Baru

WargaKas membutuhkan database kosong untuk menyimpan data transaksi keuangan organisasi Anda:

Di dashboard cPanel, cari dan buka menu MySQL® Database Wizard.
Langkah 1 (Buat Database): Masukkan nama database Anda (misal: wargakas_db), lalu klik Next Step.
Langkah 2 (Buat User): Buat username database (misal: wargakas_user) dan buat password yang kuat. Gunakan *Password Generator* untuk membuat password acak yang aman. Simpan detail ini untuk langkah selanjutnya. Klik Create User.
Langkah 3 (Hubungkan User ke DB): Centang pilihan ALL PRIVILEGES untuk memberikan hak akses penuh kepada user tersebut ke database, lalu klik Make Changes.

Konfigurasi File Koneksi Database (.env)

Hubungkan aplikasi WargaKas dengan database yang baru saja Anda buat:

Di dalam File Manager, temukan file bernama .env.example di folder instalasi WargaKas.
Ubah nama file tersebut (Rename) menjadi hanya .env (pastikan ada tanda titik di depannya).
Klik kanan file .env, pilih Edit, dan sesuaikan konfigurasi database berikut:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=nama_database_yang_anda_buat
DB_USERNAME=username_database_yang_anda_buat
DB_PASSWORD=password_database_yang_anda_buat

APP_URL=https://kas.komunitasanda.id
        

Ganti APP_URL dengan URL lengkap website/subdomain Anda (wajib menggunakan https:// untuk keamanan transfer data).

Impor Skema Database

Langkah terakhir adalah memuat struktur tabel ke dalam database Anda:

Di cPanel Anda, cari dan buka menu phpMyAdmin.
Di panel sebelah kiri, klik nama database kosong yang telah dibuat pada Langkah 2.
Klik tab Import di bagian menu atas phpMyAdmin.
Pada kolom *File to import*, klik Choose File dan pilih file skema database bernama database.sql (biasanya berada di dalam paket folder instalasi atau folder utama).
Gulir ke bawah dan klik tombol Import atau Go untuk memproses. Tunggu hingga muncul pesan sukses berwarna hijau.

Login Pertama Kali ke Dashboard Admin

Aplikasi WargaKas Anda sekarang sudah aktif! Anda dapat membukanya melalui web browser Anda.

URL Login Admin: https://kas.komunitasanda.id/login
Email Default: admin@wargakas.id
Password Default: admin123

PENTING DEMI KEAMANAN:

Setelah Anda berhasil masuk ke Dashboard Admin untuk pertama kali, segeralah pergi ke menu Pengaturan Akun dan ubah email serta password default tersebut dengan email aktif dan kata sandi baru yang sangat kuat untuk mencegah akses tidak sah.

Penyelesaian Masalah (Troubleshooting)

1. Mengatasi Error 500 (Internal Server Error)

Jika setelah instalasi Anda membuka website dan mendapatkan halaman error 500, periksa hal-hal berikut:

Izin Folder (Permissions): Pastikan folder memiliki izin akses 755 dan semua file memiliki izin 644. Gunakan File Manager cPanel untuk mengubahnya jika ada yang tidak sesuai.
Ekstensi PHP: Pastikan versi PHP yang aktif di cPanel adalah PHP 8.1+, dan semua ekstensi wajib di atas sudah dicentang/diaktifkan melalui menu Select PHP Version di cPanel Anda.

2. Mod_Rewrite / Masalah Halaman 404 Not Found

Jika Anda dapat mengakses halaman depan namun mendapatkan error 404 ketika membuka menu login atau halaman admin:

Pastikan file .htaccess bawaan WargaKas sudah terunggah dengan benar di folder instalasi Anda. File cPanel yang diawali dengan tanda titik (seperti .htaccess atau .env) terkadang tersembunyi. Aktifkan opsi "Show Hidden Files" di pengaturan File Manager cPanel Anda untuk memastikannya ada.