Panduan lengkap dari nol: memilih cara pemasangan, menjalankan installer, sampai memakai setiap fiturnya.
Ada tiga cara memasang: shared hosting (paling gampang), VPS dengan Docker (paling rapi), atau VPS native (paling ramping). Pilih salah satu, karena langkah awalnya sama untuk ketiganya.
Cocok kalau kamu sudah punya paket hosting. Tanpa SSH dan tanpa baris perintah: semuanya dari browser dan File Manager.
Satu perintah untuk menyalakan Nginx, PHP-FPM, MySQL, dan phpMyAdmin sekaligus. Cara ini TIDAK memakai halaman /install: kredensial database ditanam saat container dibuat.
Kalau VPS kamu sudah menjalankan Nginx + PHP-FPM untuk situs lain, mode ini menghindari duplikasi container. Instalasinya memakai halaman /install seperti shared hosting.
Cocok kalau kamu sudah punya paket hosting. Tanpa SSH dan tanpa baris perintah: semuanya dari browser dan File Manager.
YouTubeCara Installasi Suka Duit di Shared Hosting (cPanel)Video panduan step-by-step cara install Suka Duit di Shared Hosting (cPanel).Struktur folder aplikasi memisahkan kode dari area publik. Yang boleh diakses browser cuma isi public/. Sisanya (app/, system/, writable/) harus berada di luar jangkauan langsung.
suka-duit/
├── app/ ← kode aplikasi (jangan diekspos)
├── public/ ← document root mengarah ke SINI
│ └── index.php
├── system/ ← framework CodeIgniter
├── writable/ ← session, cache, log (harus bisa ditulis)
└── .env ← dibuat otomatis oleh installerMasuk cPanel → File Manager → buka public_html (atau www). Unggah arsip aplikasi lalu Extract di sana.
Kalau hosting kamu menyediakan fitur pemilih document root, arahkan domain ke folder public/. Kalau tidak, lihat catatan di Langkah 1.
Di cPanel → MySQL Databases, buat satu database baru, lalu buat user MySQL dan berikan user itu akses penuh ke database tersebut.
Catat tiga nilai ini untuk nanti dimasukkan di halaman instalasi: nama database, username, dan password.
Satu perintah untuk menyalakan Nginx, PHP-FPM, MySQL, dan phpMyAdmin sekaligus. Cara ini TIDAK memakai halaman /install: kredensial database ditanam saat container dibuat.
Setelah SSH masuk ke VPS, letakkan folder aplikasi di direktori kerja (misalnya /var/www/suka-duit). Pastikan Docker dan Docker Compose v2 sudah terpasang.
docker --version
docker compose version
docker infoDocker tidak punya kesempatan menanyakan kredensial lewat browser, jadi isi .env dulu. Salin dari contoh yang tersedia, lalu ganti dua nilai placeholder-nya.
cp .env.example .env
# wajib diganti. Pakai password acak, jangan yang gampang ditebak:
# DB_PASSWORD
# MYSQL_ROOT_PASSWORDAda dua pilihan: skrip setup yang sekaligus menunggu database sehat dan menjalankan migrasi, atau perintah compose manual.
./setup.shKalau VPS kamu sudah menjalankan Nginx + PHP-FPM untuk situs lain, mode ini menghindari duplikasi container. Instalasinya memakai halaman /install seperti shared hosting.
Minimal PHP 8.2 dengan ekstensi intl, mbstring, dan mysqli. Contoh perintah untuk Debian/Ubuntu:
sudo apt update
sudo apt install nginx php8.2-fpm php8.2-intl \
php8.2-mbstring php8.2-mysql mysql-serverIni langkah keamanan paling penting di mode native: web server hanya boleh menyentuh folder public/. Semua permintaan diarahkan ke index.php di dalamnya.
server {
listen 80;
server_name keuangan.domainku.com;
root /var/www/suka-duit/public;
index index.php;
location / {
try_files $uri $uri/ /index.php?/$request_uri;
}
location ~ \.php$ {
fastcgi_pass unix:/run/php/php8.2-fpm.sock;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
location ~ /\.(?!well-known).* { deny all; }
}Web server perlu bisa menulis di writable/ dan membuat .env. Setelah itu, sisa langkahnya sama seperti di browser.
sudo chown -R www-data:www-data /var/www/suka-duit
sudo chmod -R 775 /var/www/suka-duit/writableHalaman ini dipakai oleh cara shared hosting dan VPS native. Isinya lima langkah, semuanya di browser.
Installer memeriksa versi PHP, ketersediaan ekstensi intl/mbstring/mysqli, izin tulis folder writable/, dan apakah .env bisa dibuat. Semua harus centang hijau sebelum kamu bisa lanjut.
Semua syarat centang hijau. Kalau ada yang merah, penyebabnya tertulis di baris itu sendiri.
Nama dan tagline yang akan tampil di sidebar serta judul halaman. Isi apa saja. Keduanya bisa diganti kapan pun setelah aplikasi jalan, tanpa menyentuh file.
Masukkan host, port, nama database, username, dan password. Di shared hosting maupun VPS native, host-nya biasanya localhost. Kalau ragu, cek panduan penyedia hosting kamu.
Kalau kredensialnya benar, muncul kotak hijau. Pesannya sekaligus memberi tahu kondisi database: kosong dan siap dipasang baru, atau sudah ada data lama.
Statusnya jelas di kartu yang sama, tanpa perlu membuka phpMyAdmin untuk tahu database-nya kosong.
Akun pertama ini otomatis berperan sebagai administrator, jadi hanya dia yang bisa mengelola user lain dan mengubah identitas aplikasi.
Dua pilihan sederhana: mulai dengan dompet kosong, atau isi data contoh supaya dashboard langsung terlihat hidup dan gampang dipelajari.
Installer membuat tabel, menulis .env, menandai instalasi selesai, lalu langsung mengarahkan kamu ke dashboard dalam keadaan sudah login.
Setelah ini halaman /install menutup dirinya sendiri. Kalau dibuka lagi, kamu cuma akan dilempar ke dashboard.
Penanda instalasi ditulis ke writable/installed.lock.
Kalau kamu memilih data contoh, dashboard sudah terisi: saldo, arus kas bulan berjalan, grafik harian, dan peringatan budget. Semua angka di layar ini berasal dari database yang baru saja kamu buat.
Instalasi selesai tanpa satu pun langkah baris perintah.
Urutannya mengikuti alur pemakaian sehari-hari: masuk, melihat dashboard, mencatat transaksi, lalu mengatur kategori, laporan, dan dompet keluarga. Tangkapan layar di bagian ini punya dua versi. Yang tampil menyesuaikan tema halaman yang sedang kamu pakai.
/login · /registerHalaman masuk dan pendaftaran akun mandiri. Administrator bisa menutup pendaftaran publik kalau aplikasinya hanya untuk keluarga atau tim tertutup. Setelah ditutup, akun baru cuma bisa dibuat admin lewat Settings.
/dashboardRingkasan satu layar: total saldo dompet aktif, arus kas bulan berjalan, komposisi pemasukan dan pengeluaran per kategori, grafik harian, plus peringatan budget yang hampir habis.
/transactionsRiwayat lengkap dikelompokkan per tanggal dengan total harian. Ada pencarian bebas, filter jenis, dan filter kategori untuk menelusuri catatan lama.
modal di /transactionsSatu formulir untuk tiga jenis transaksi. Jenis menentukan kategori dan kolom yang muncul, jadi kamu tidak perlu memilih dari daftar yang tidak relevan.
/categories · /category/{id}Kelola pos pemasukan dan pengeluaran dalam dua kolom terpisah. Setiap kategori bisa diberi ikon dan warna sendiri supaya gampang dikenali sekilas.
/category/{id}Halaman satu kategori: total pengeluaran, jumlah transaksi, pengaturan budget bulan berjalan, dan riwayat transaksi kategori itu.
/reportKomposisi pengeluaran per kategori untuk bulan yang dipilih, lengkap dengan persentase dan rincian transaksinya. Berguna saat ingin tahu ke mana uang sebenarnya pergi.
/settings/walletsKelola banyak dompet sekaligus: pribadi, keluarga, atau bisnis. Setiap dompet punya anggota dan perannya sendiri, jadi catatan bisa dipisah rapi.
/settings/wallets/detailKartu dompet menampilkan saldo total, kode invite, tautan undangan, dan daftar anggotanya beserta peran masing-masing.
/settingsSemua pengaturan dikumpulkan di satu halaman berkartu: profil, dompet, keamanan, tampilan, backup, AI/MCP, pengguna, identitas aplikasi, dan info versi.
/settings/account · /settings/securityUbah nama tampilan dan alamat email, atau ganti password dengan memverifikasi password lama terlebih dahulu.
/settings/appearanceAtur mode terang/gelap, tema warna, jenis font, dan ukuran teks. Ada pratinjau hidup di atas formulir supaya perubahan langsung terlihat sebelum disimpan.
/settings/backupUnduh salinan data akun dalam format JSON, lalu pulihkan lagi dari file backup kapan pun dibutuhkan.
/settings/mcpSuka Duit punya MCP server bawaan, jadi AI agent seperti Claude Desktop atau Hermes bisa membaca dan mencatat keuangan langsung dari jendela chat.
/settings/usersHalaman khusus administrator: lihat total pengguna, tambah akun baru, atur peran, dan nyalakan atau matikan pendaftaran publik.
/settings/identityGanti nama dan tagline aplikasi langsung dari dalam aplikasi. Perubahan berlaku di sidebar, judul halaman, sampai nama aplikasi pada manifest PWA.
semua halamanSeluruh antarmuka dirancang mobile-first. Sidebar berubah jadi laci, tombol Tambah Transaksi menempel di bagian bawah, dan aplikasi bisa dipasang ke layar utama.
Masalah yang paling sering muncul saat pemasangan, beserta jalan keluarnya.
Buka writable/logs/log-YYYY-MM-DD.log. Pesan error sebenarnya ada di sana.
Pastikan folder writable/ bisa ditulis (755, atau 775 kalau masih gagal).
chmod -R 755 writable/Folder utama aplikasi harus bisa ditulis web server. Kalau hosting mengunci folder, buat file .env kosong lebih dulu, lalu beri izin tulis 644.
Pindahkan semua isi folder public/ ke folder utama, lalu edit index.php yang sudah dipindah pada baris require-nya.
require FCPATH . '../app/Config/Paths.php';
// ubah menjadi:
require FCPATH . './app/Config/Paths.php';Periksa ulang host, nama database, username, dan password di panel hosting kamu.
Pastikan user MySQL sudah diberi akses ke database itu. Beberapa panel mengharuskan user ditambahkan ke database secara terpisah.
Pastikan ekstensi mysqli aktif. Di Docker, host-nya adalah mysql, bukan localhost.
Matikan pemaksaan HTTPS di .env, lalu pastikan sertifikat SSL-nya memang valid.
app.forceGlobalSecureRequests = falseAplikasi ini tidak mengirim email, jadi tidak ada fitur lupa password. Reset dilakukan dari database: buka tabel users lewat phpMyAdmin, tempel hash password sementara di kolom password, lalu login dan segera ganti password dari Settings.
Penting: pada kolom Function di phpMyAdmin, biarkan kosong. Kalau diisi, nilainya akan diubah lagi oleh fungsi tersebut.
UPDATE users
SET password = '<hash_password_sementara>'
WHERE email = 'emailkamu@domain.com';Instalasi dikenali dari dua hal: berkas penanda writable/installed.lock sebagai cache cepat, dan tabel users di database sebagai penentu utama. Kalau datanya masih ada, aplikasi tetap mengenali dirinya sebagai terinstall meski penandanya hilang.
Untuk menghubungkan ulang ke database lama: hapus .env (dan installed.lock kalau ada), buka /install, masukkan kredensial database lama, lalu pilih Gunakan Data yang Ada (Rekomendasi).
Untuk memulai dari nol: hapus .env dan installed.lock, buka /install, pakai kredensial yang sama, lalu pilih Pasang Baru (Hapus Data Lama).
Kalau ada langkah yang kurang jelas atau lingkunganmu berbeda dari yang dijelaskan di sini, tanyakan langsung lewat WhatsApp. Sebutkan cara pemasangan yang kamu pakai supaya jawabannya cepat.