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:

git clone https://github.com/buku-masjid/buku-masjid.git

• Masuk ke direktori aplikasi:

cd buku-masjid

• Instal dependensi yang diperlukan dengan Composer:

composer install

• Salin berkas contoh konfigurasi .env ke berkas baru .env:

cp .env.example .env

• Generate kunci aplikasi untuk keamanan:

php artisan key:generate

• Buat database MySQL untuk aplikasi ini dan catat kredensialnya.
• Konfigurasikan pengaturan database dan informasi lain pada berkas .env. Contoh konfigurasi adalah sebagai berikut:

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="."

• Jalankan migrasi database untuk mengatur struktur tabel:

php artisan migrate --seed

• Buat kunci Passport untuk otentikasi API:

php artisan passport:keys

• Buat tautan untuk penyimpanan:

php artisan storage:link

• Terakhir, jalankan server dengan perintah:

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 install dalam 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 Sekarang