Cara Install Buku Masjid Aplikasi Keuangan Masjid di Ubuntu 24.04
Buku Masjid adalah aplikasi berbasis web yang dirancang untuk mengelola keuangan dan jadwal pengajian masjid. Dalam tutorial ini, kita akan membahas langkah-langkah untuk menginstal aplikasi ini pada sistem operasi Ubuntu 24.04.
Prasyarat
Sebelum memulai instalasi, pastikan Anda memenuhi persyaratan berikut:
- Ubuntu 24.04 terinstal di sistem Anda.
- Instalasi PHP versi 8.1 atau lebih baru.
- Database MySQL atau MariaDB, serta SQLite untuk pengujian.
- Composer, manajer dependensi untuk PHP.
- Git untuk meng-clone repositori aplikasi.
Langkah Utama
Berikut adalah langkah-langkah instalasi Buku Masjid di Ubuntu 24.04:
- Clone repositori Buku Masjid menggunakan perintah berikut:
- Masuk ke direktori aplikasi:
- Instal dependensi yang diperlukan dengan Composer:
- Salin berkas contoh konfigurasi .env ke berkas baru .env:
- Generate kunci aplikasi untuk keamanan:
- Buat database MySQL untuk aplikasi ini dan catat kredensialnya.
- Konfigurasikan pengaturan database dan informasi lain pada berkas .env. Contoh konfigurasi adalah sebagai berikut:
- Jalankan migrasi database untuk mengatur struktur tabel:
- Buat kunci Passport untuk otentikasi API:
- Buat tautan untuk penyimpanan:
- Terakhir, jalankan server dengan perintah:
git clone https://github.com/buku-masjid/buku-masjid.git
cd buku-masjid
composer install
cp .env.example .env
php artisan key:generate
APP_URL=http://localhost
APP_TIMEZONE="Asia/Makassar"
DB_DATABASE=nama_database
DB_USERNAME=nama_pengguna
DB_PASSWORD=password_database
MASJID_NAME="Masjid Ar-Rahman"
MASJID_DEFAULT_BOOK_ID=1
AUTH_DEFAULT_PASSWORD=password
MONEY_CURRENCY_CODE="Rp"
MONEY_PRECISION=2
MONEY_DECIMAL_SEPARATOR=","
MONEY_THOUSANDS_SEPARATOR="."
php artisan migrate --seed
php artisan passport:keys
php artisan storage:link
php artisan serve
Setelah server berjalan, buka browser dan akses http://localhost:8000.
Konfigurasi Lanjutan
Setelah instalasi dasar, Anda mungkin ingin melakukan beberapa konfigurasi lanjutan, seperti:
- Menambahkan pengguna baru: Gunakan perintah artisan untuk membuat pengguna baru dengan hak akses yang diperlukan.
- Menyesuaikan laporan: Modifikasi template laporan untuk memenuhi kebutuhan masjid Anda.
- Backup database: Pastikan untuk secara berkala membackup database agar data keuangan Anda aman.
- Integrasi dengan sistem lain: Anda dapat mengintegrasikan dengan sistem lain seperti pembayaran online untuk kemudahan transaksi.
Best Practices
Untuk memastikan aplikasi berjalan dengan baik, pertimbangkan praktik terbaik berikut:
- Selalu gunakan versi PHP yang didukung dan perbarui aplikasi secara berkala.
- Amankan file .env agar tidak dapat diakses publik.
- Gunakan HTTPS untuk mengamankan data yang ditransmisikan antara server dan pengguna.
- Implementasikan sistem backup yang terjadwal untuk database.
- Lakukan audit keamanan secara berkala untuk mengidentifikasi dan memperbaiki potensi kerentanan.
Troubleshooting
Jika Anda mengalami masalah saat menginstal atau menjalankan Buku Masjid, berikut adalah beberapa solusi yang dapat dicoba:
- Masalah koneksi database: Periksa pengaturan database di berkas .env dan pastikan database sudah dibuat.
- Kesalahan saat menginstal dependensi: Pastikan Composer terinstal dan jalankan perintah
composer installdalam direktori proyek. - Server tidak merespon: Pastikan server Laravel aktif dengan perintah
php artisan serve. - Masalah izin: Cek izin folder storage dan bootstrap/cache, pastikan dapat ditulis.
Kesimpulan
Instalasi Buku Masjid di Ubuntu 24.04 memungkinkan Anda untuk memiliki sistem pengelolaan keuangan dan jadwal pengajian yang efisien. Dengan mengikuti langkah-langkah yang dijelaskan, Anda dapat dengan mudah mengatur aplikasi ini untuk masjid atau mushalla Anda, serta meningkatkan transparansi dan kemudahan dalam pengelolaan keuangan.
Jika Anda memerlukan bantuan lebih lanjut atau konsultasi, silakan hubungi tim kami melalui WhatsApp dengan mengklik tautan berikut:
Konsultasi Jasa Setup SekarangVerifikasi Teknis
Panduan ini disusun berdasarkan referensi teknis terbaru. Namun, konfigurasi server dapat bervariasi. Lihat sumber referensi asli →
