Sebelum instal aplikasi PBB disarankan instal pada daftar dibawah ini terlebih dahulu :
1. Instal OpenSID.
2. Instal OpenSID API.
Untuk menjalankan aplikasi PBB ada beberapa kebutuhan teknis yang harus dipenuhi yaitu :
download source code
atau menggunakan git
.Pelanggan Fitur OpenSID
atau dapat diunduh melalui repo https://github.com/OpenSID/rilis-pbb/releases.tags
repo tersebut.Menggunakan file download .zip
atau .tar.gz
:
tags
versi terbaru.langkah 3
.Menggunakan git
:
git clone https://github.com/OpenSID/rilis-pbb.git pbb_desa
cd pbb_desa
langkah 3
.
Langkah 3: Membuat Env
APP_NAME="Aplikasi PBB"
APP_ENV=production
APP_KEY=
APP_DEBUG=false
APP_URL=http://localhost
ASSET_URL=null
LOG_CHANNEL=stack
LOG_DEPRECATIONS_CHANNEL=null
LOG_LEVEL=debug
DB_CONNECTION=mysql
DB_HOST=localhost
DB_PORT=3306
DB_DATABASE=opensid_pbb
DB_USERNAME=root
DB_PASSWORD=
DB_MIGRATE=false
BROADCAST_DRIVER=log
CACHE_DRIVER=file
FILESYSTEM_DISK=public
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=mailhog
MAIL_PORT=1025
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_ENCRYPTION=null
MAIL_FROM_ADDRESS=null
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}"
WEB_DEMO=false #website-demo
# Config premium ubah untuk production
KODE_DESA= #required
HOST_PREMIUM=https://layanan.opendesa.id
TOKEN_PREMIUM= #required
MYSQLDUMP_PATH='/usr/bin/mysqldump'
# default connection ke database utama
DB_CONNECTION=di isi dengan jenis database
# database
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
Berikut contoh hasil env.
APP_NAME="Aplikasi PBB"
APP_ENV=production
APP_KEY=base64:5Gs02LxlODDIvcnabQ0fY5YGIYSLbTWawREUW+g3MYA=
APP_DEBUG=false
APP_URL=https://demopbb.opendesa.id
ASSET_URL=null
LOG_CHANNEL=daily
LOG_DEPRECATIONS_CHANNEL=null
LOG_LEVEL=debug
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=pbb_desa
DB_USERNAME=root
DB_PASSWORD=rahasia
DB_MIGRATE=true
BROADCAST_DRIVER=log
CACHE_DRIVER=file
FILESYSTEM_DISK=public
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=mailhog
MAIL_PORT=1025
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_ENCRYPTION=null
MAIL_FROM_ADDRESS=null
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}"
WEB_DEMO=false #website-demo
# Config premium ubah untuk production
KODE_DESA=0000000000
HOST_PREMIUM=https://layanan.opendesa.id
TOKEN_PREMIUM=xxxxxxxxxxxxxxxxxxxxxx.eyJpc3MiOiJodHRwczpcL1wvZGV2bGF5YW5hbi5vcGVuZGVzYS5pZCIsImlhdCI6MTY4ODIwMjUzMywiZXhwIjoxNjg4NDYxNzMzLCJuYmYiOjE2ODgyMDI1MzMsImp0aSI6IjY1ZjRhMjcwNmRjN2NiZTg2Zjg4NjIwN2M2MzljNDkyOWNjYTQxN2NjZDY0YTgwNzAxMGE1ZTdlOGFiMDg3ZDUiLCJzdWIiOiIxNjUyIiwicHJ2IjoiZjkzMDdlYjVmMjljNzJhOTBkYmFhZWYwZTI2ZjAyNjJlZGU4NmY1NSIsImRlc2FfaWQiOiIxOC4xMi4wOC4yMDA1Iiwia2VjYW1hdGFuX2lkIjoiIiwiZG9tYWluIjoiaHR0cHM6XC9cL2JldGEub3BlbmRlc2EuaWQiLCJ0YW5nZ2FsX2JlcmxhbmdnYW5hbiI6eyJtdWxhaSI6IjIwMjItMDctMDUiLCJha2hpciI6IjIwMjMtMDctMDQifX0.2E8LrwfifmkNp7CnArok0aUTWG9B5oTvp8TKo409z2I
# default untuk hosting dengan OS linux biasanya /usr/bin/mysqldump, jika menggunakan OS Windows silakan disesuaikan dengan path mysqldump
MYSQLDUMP_PATH='/usr/bin/mysqldump'
php artisan key:generate
php artisan migrate --seed
php artisan storage:link
php artisan serve
Install Aplikasi PBB di server sebaiknya menggunakan git
dengan pertimbangan ketika update ke versi berikutnya akan lebih mudah. Berikut langkah instal Aplikasi PBB di Server Hosting:
git clone https://github.com/OpenSID/rilis-pbb.git pbb_desa
cd pbb_desa
composer install --no-dev
.env.example
dan ubah menjadi .env
.key generate
.php artisan key:generate
.env
(lihat di konfigurasi)php artisan migrate --seed
cd ..
<nama domain>
diubah misalkan pbb.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 pbb_desa/public <nama domain>
cd pbb_desa
php artisan storage:link
.env
DB_CONN=mysql
DB_HOST=localhost
DB_PORT=3306
DB_NAME=opensid_pbb
DB_USER=root
DB_PASS=
DB_CONN=mariadb
DB_HOST=localhost
DB_PORT=3306
DB_NAME=opensid_pbb
DB_USER=root
DB_PASS=
DB_CONN=postgres
DB_HOST=localhost
DB_PORT=5432
DB_NAME=opensid_pbb
DB_USER=root
DB_PASS=
.env
#required
disesuaikan desa Anda yaitu isi kode desa dan token_premium yang didapatkan dari pelaksana.HOST_PREMIUM=https://layanan.opendesa.id
KODE_DESA= #required
TOKEN_PREMIUM= #required
Konfigurasi pada file .env
MAIL_MAILER=smtp
MAIL_HOST=ssl://smtp.gmail.com
MAIL_PORT=465
MAIL_USERNAME=contoh@gmail.com
MAIL_PASSWORD=password
MAIL_ENCRYPTION=tls
MAIL_FROM_ADDRESS=info@gmail.com
MAIL_FROM_NAME="${APP_NAME}"
Konfigurasi pada file .env
DB_MIGRATE=false
Pelanggan Fitur OpenSID
atau hubungi tim pelaksana dengan cara klik link ini.Command Prompt
atau terminal pada editor seperti Visual Studio Code
.C:\xampp\htdocs\pbb_desa>
composer install --no-dev
pbb_opensid
dan impor file pajak.sql
yang ada di dalam folder pbb_desa/database..env.example
menjadi .env
kemudian sesuaikan isinya (cara konfigurasi)..htaccess.example
menjadi .htaccess
.admin
dan password : admin
untuk melakukan login.Pada panduan ini kita akan melakukan deploy aplikasi pada share hosting. kita akan melakukan deploy pada alamat http://aplikasipbb.demo.opensid.my.id, langkah pertama adalah membuat subdomain nya terlebih dahulu dengan cara seperti ini
Sebelum melakukan proses upload, pastikan lokasi folder yang menjadi target upload sudah benar, jika sudah maka silakan klik upload
untuk melakukan upload source code aplikasi PBB yang sudah anda download.
Sekarang pilih file aplikasi PBB yang akan di upload dengan klik tombol Select File
dan tunggu sampai proses upload selesai 100%.
Setelah proses upload selesai, langkah selanjutnya adalah melakukan proses extract file, silakan klik kanan pada file dan pilih Extract
.
Kemudian pilih Extract files here
untuk memulai proses.
Setelah proses extract selesai maka selanjutnya kita akan melihat sebuah folder baru dengan nama pbb_desa-master
, ini adalah folder aplikasi PBB.
Sekarang semua file harus dipindahkan ke folder subdomain utama, silakan pilih semua file, klik kanan dan pilih move
.
Sampai tahap ini proses upload file dan restruktur file sudah selesai dan ketika domain di akses akan muncul seperti ini.
Aplikasi PBB sudah menggunakan composer sebagai management library, jadi pastikan vendor hosting anda sudah support composer dan bisa di akses melalui terminal.
Kemudian silakan masuk ke folder project dan ketik perintah composer install --no-dev
untuk melakukan instalasi.
Kemudian silakan rename file .env.example
menjadi .env
dan .htaccess.example
menjadi .htaccess
seperti dibawah ini.
Tahapan selanjutnya adalah melakukan pembuatan database yang akan digunakan nantinya.
Setelah selesai membuat database, langah selanjutnya adalah membuat user MySQL
.
Kemudian memberikan akses user ke database tersebut.
Tambahkan privileges dan klik simpan.
Langkah selanjutnya adalah melakukan upload database, silakan buka PhpMyAdmin, klik import dan pilih database.
Jika proses import berhasil maka akan muncul list tabel seperti berikut.
Langkah selanjutnya adalah konfigurasi database, silakan buka file .env dan sesuaikan konfigurasi.
Ubah source code berikut
CI_ENV=production
Jika sudah selesai semua, seharusnya aplikasi sudah bisa di akses dengan baik.
Konfigurasi file .env
CI_ENV=production
BASE_URL=http://localhost/pbb_desa
DB_CONN=mysqli
DB_HOST=localhost
DB_PORT=3306
DB_NAME=pbb_opensid
DB_USER=root
DB_PASS=
CI_ENV=production
BASE_URL=http://localhost/pbb_desa
DB_CONN=mariadb
DB_HOST=localhost
DB_PORT=3306
DB_NAME=pbb_opensid
DB_USER=root
DB_PASS=
CI_ENV=production
BASE_URL=http://localhost/pbb_desa
DB_CONN=postgres
DB_HOST=localhost
DB_PORT=5432
DB_NAME=pbb_opensid
DB_USER=root
DB_PASS=
Masalah yang mungkin terjadi pada saat instalasi diantaranya:
Ketika melakukan perintah php artisan migrate --seed dan muncul pesan seperti gambar di bawah ini:
Solusinya adalah jalankan perintah dibawah ini, lalu jalankan kembali perintah migrasi:
ALTER DATABASE <database_name> CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
php artisan db:wipe
php artisan migrate --seed --force