Sebelum instal aplikasi PBB disarankan instal pada daftar dibawah ini terlebih dahulu :
1. Instal OpenSID.
2. Aplikasi Dashboad Siap Pakai.
¶ Kebutuhan Sistem
Untuk menjalankan aplikasi OpenKab ada beberapa kebutuhan teknis yang harus dipenuhi yaitu :
- PHP versi 8.xx atau setelahnya.
- PHP Extension mysqli dan driver pdo.
¶ Instal Aplikasi
- Instal Aplikasi OpenKab dapat dilakukan dengan beberapa cara, diantaranya
download source codeatau menggunakangit. - Aplikasi OpenKab rilis terbaru akan diinfokan di grup telegram
Pelanggan Fitur OpenSIDatau dapat diunduh melalui repo https://github.com/OpenSID/OpenKab/releases/. - Informasi mengenai catatan rilis tentang penambahan fitur, perbaikan bug, atau teknis ada pada
tagsrepo tersebut.
Menggunakan file download .zip atau .tar.gz :
- Unduh salah satu source code yang ada dipaling bawah
tagsversi terbaru.
- Exract hasil unduhan dan upload hasil extra tersebut ke server
- Silakan lanjut ke
langkah 3.
Menggunakan git :
- Buka terminal pada editor vs.code atau menggunakan cmd kemudian ketikan perintah berikut:
git clone https://github.com/OpenSID/OpenKab.git openkab
- Pindah ke folder pbb_desa
cd openkab
- Silakan lanjut ke
langkah 3.
¶
Langkah 3:
- Buat database untuk Aplikasi Openkab.
Langkah 4: Membuat Env
- Buat file .env dan copy paste isi dari file .env.excample
APP_NAME=OpenKab
APP_ENV=local
APP_KEY=
APP_DEBUG=true
APP_URL=http://localhost
LOG_CHANNEL=stack
LOG_DEPRECATIONS_CHANNEL=null
LOG_LEVEL=debug
# default connection ke database utama
DB_CONNECTION=mysql
# database utama aplikasi openkab
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=openkab
DB_USERNAME=root
DB_PASSWORD=
# database kedua, opensid database gabungan
OPENKAB_DB_HOST=127.0.0.1
OPENKAB_DB_PORT=3306
OPENKAB_DB_DATABASE=opensid_premium
OPENKAB_DB_USERNAME=root
OPENKAB_DB_PASSWORD=
BROADCAST_DRIVER=log
CACHE_DRIVER=file
FILESYSTEM_DISK=local
QUEUE_CONNECTION=sync
SESSION_DRIVER=file
SESSION_LIFETIME=120
MEMCACHED_HOST=127.0.0.1
REDIS_HOST=127.0.0.1
REDIS_PASSWORD=null
REDIS_PORT=6379
MAIL_MAILER=smtp
MAIL_HOST=mailpit
MAIL_PORT=1025
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_ENCRYPTION=null
MAIL_FROM_ADDRESS="hello@example.com"
MAIL_FROM_NAME="${APP_NAME}"
AWS_ACCESS_KEY_ID=
AWS_SECRET_ACCESS_KEY=
AWS_DEFAULT_REGION=us-east-1
AWS_BUCKET=
AWS_USE_PATH_STYLE_ENDPOINT=false
PUSHER_APP_ID=
PUSHER_APP_KEY=
PUSHER_APP_SECRET=
PUSHER_HOST=
PUSHER_PORT=443
PUSHER_SCHEME=https
PUSHER_APP_CLUSTER=mt1
VITE_PUSHER_APP_KEY="${PUSHER_APP_KEY}"
VITE_PUSHER_HOST="${PUSHER_HOST}"
VITE_PUSHER_PORT="${PUSHER_PORT}"
VITE_PUSHER_SCHEME="${PUSHER_SCHEME}"
VITE_PUSHER_APP_CLUSTER="${PUSHER_APP_CLUSTER}"
#SERVER PANTAU
APP_PANTAU=
TOKEN_PANTAU=
# FTP_X_HOST dst = Tambahkan dan ubah (x) dengan angka untuk menentukan desa berdasarkan id pada value di table `config`
FTP_1_HOST= #berputar.opensid.or.id
FTP_1_URL=https://berputar.opensid.or.id
FTP_1_ROOT=
FTP_1_USERNAME=
FTP_1_PASSWORD=
FTP_1_PORT=
FTP_1_TIMEOUT=1
Langkah 4: Konfigursi file Env
Konfigurasi pada file.env(lihat di konfigurasi)
Berikut contoh hasil env.
APP_NAME=OpenKab
APP_ENV=production
APP_KEY=
APP_DEBUG=false
APP_URL=http://localhost
LOG_CHANNEL=stack
LOG_DEPRECATIONS_CHANNEL=null
LOG_LEVEL=debug
# default connection ke database utama
DB_CONNECTION=mysql
# database utama aplikasi openkab
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=openkab
DB_USERNAME=root
DB_PASSWORD=123456
# database kedua, opensid database gabungan
OPENKAB_DB_HOST=127.0.0.1
OPENKAB_DB_PORT=3306
OPENKAB_DB_DATABASE=opensid_premium
OPENKAB_DB_USERNAME=root
OPENKAB_DB_PASSWORD=123456
BROADCAST_DRIVER=log
CACHE_DRIVER=file
FILESYSTEM_DISK=local
QUEUE_CONNECTION=sync
SESSION_DRIVER=file
SESSION_LIFETIME=120
MEMCACHED_HOST=127.0.0.1
REDIS_HOST=127.0.0.1
REDIS_PASSWORD=null
REDIS_PORT=6379
MAIL_MAILER=smtp
MAIL_HOST=sandbox.smtp.mailtrap.io
MAIL_PORT=2525
MAIL_USERNAME=8c1875d6fd3c6a
MAIL_PASSWORD=70f9ab33a55e5d
MAIL_ENCRYPTION=tls
MAIL_FROM_ADDRESS="openkab@gmail.com"
MAIL_FROM_NAME="${APP_NAME}"
AWS_ACCESS_KEY_ID=
AWS_SECRET_ACCESS_KEY=
AWS_DEFAULT_REGION=us-east-1
AWS_BUCKET=
AWS_USE_PATH_STYLE_ENDPOINT=false
PUSHER_APP_ID=
PUSHER_APP_KEY=
PUSHER_APP_SECRET=
PUSHER_HOST=
PUSHER_PORT=443
PUSHER_SCHEME=https
PUSHER_APP_CLUSTER=mt1
VITE_PUSHER_APP_KEY="${PUSHER_APP_KEY}"
VITE_PUSHER_HOST="${PUSHER_HOST}"
VITE_PUSHER_PORT="${PUSHER_PORT}"
VITE_PUSHER_SCHEME="${PUSHER_SCHEME}"
VITE_PUSHER_APP_CLUSTER="${PUSHER_APP_CLUSTER}"
#SERVER PANTAU
APP_PANTAU=
TOKEN_PANTAU=
# FTP_X_HOST dst = Tambahkan dan ubah (x) dengan angka untuk menentukan desa berdasarkan id pada value di table `config`
FTP_1_HOST= #berputar.opensid.or.id
FTP_1_URL=https://berputar.opensid.or.id
FTP_1_ROOT=
FTP_1_USERNAME=
FTP_1_PASSWORD=
FTP_1_PORT=
FTP_1_TIMEOUT=1
- Setelah konfigurasi .env terisi, jalankan perintah key generate untuk memproduksi app key. perintah untuk key generate :
php artisan key:generate
- Jalankan perintah Migrasi
php artisan migrate --seed
- Tambahkan storage (agar dapat simpan/ubah gambar).
php artisan storage:link
- Jalankan perintah berikut untuk keluar dari folder pbb_desa
cd ..
- Buat symlink,
<nama domain>diubah misalkan openkab.namadesa.opendesa.id, namun sebelum jalankan perintah symlink, silakan dihapus terlebih dahulu nama domainnya.
perintah menghapus folder nama domain dari terminal :
sudo rm -r <nama domain>
perintah symlink
ln -s openkab/public <nama domain>
¶ Konfigurasi
¶ Konfigurasi Database
- Konfigurasi file
.env - Silakan disesuaikan dengan nama database, user, dan password desa Anda.
# default connection ke database utama
DB_CONNECTION=di isi dengan jenis database
# database utama aplikasi openkab
DB_HOST=di isi dengan url / ip server database
DB_PORT=di isi dengan port database. defauilt 3306
DB_DATABASE=di isi dengan nama database
DB_USERNAME=di isi dengan username database
DB_PASSWORD=di isi dengan password database
OPENKAB_DB_HOST=di isi dengan url / ip server database
OPENKAB_DB_PORT=di isi dengan port database. defauilt 3306
OPENKAB_DB_DATABASE=di isi dengan nama database OpenSid
OPENKAB_DB_USERNAME=di isi dengan username database
OPENKAB_DB_PASSWORD=di isi dengan password
¶ Pengaturan Aplikasi
APP_NAME=di isi dengan nama aplikasi
APP_ENV=di isi dengan mode production atau local
APP_KEY=kosongkan, akan terisi otomasti saat kita mengetik perintah php artisan key:generate
APP_DEBUG=di isi dengan false untuk production dan true untuk development
APP_URL=isi dengan url domain aplikasi
¶ Pengaturan Email
MAIL_MAILER=di isi dengan SMTP
MAIL_HOST=di isi dengan url host server Email
MAIL_PORT=di isi dengan port server email
MAIL_USERNAME=di isi dengan username email
MAIL_PASSWORD=di isi dengan username password
MAIL_ENCRYPTION=di isi dengan jenis enkripsi yang dipakai, default TLS
MAIL_FROM_ADDRESS=di isi dengan alamat email
MAIL_FROM_NAME="${APP_NAME}"