Menjalankan server Qentry

Qentry berjalan di satu PC server yang dipasang oleh supplier Qentry Anda. Panduan ini membahas perawatan harian PC tersebut. Cara memakai aplikasinya ada di Panduan Pengguna.

Serahkan instalasi, perubahan pengaturan dan uninstall kepada supplier Anda; pembaruan bisa Anda jalankan sendiri (lihat Memperbarui ke versi baru). Jangan ubah atau hapus .env di folder qentry: file itu berisi password database server ini, dan tanpa file itu database tidak bisa dibuka.

Masuk

Masuk di http://<server>/dashboard/ dengan akun Company admin yang diberikan supplier Anda. Dari situ Anda membuat akun untuk staf Anda. Akun admin milik supplier Anda.

Aplikasi

Dari perangkat mana pun di jaringan yang sama, ganti <server> dengan alamat IP server, misalnya 192.168.0.114:

Aplikasi	Alamat	Dipakai di
Dashboard	`http://<server>/dashboard/`	PC admin: perusahaan, cabang, layanan, loket, pengguna, media, laporan
Caller	`http://<server>/caller/`	PC setiap loket: memanggil tiket berikutnya
Display	`http://<server>/display/`	TV ruang tunggu
Layar loket	`http://<server>/counter/`	Tablet di setiap loket, menghadap pelanggan
Kiosk	`http://<server>/kiosk/`	Kiosk tiket dengan printer struk
Resto	`http://<server>/resto/`	Tablet penyambut tamu restoran: daftar tunggu

Saat kiosk pertama kali dibuka, layar penyiapannya meminta alamat server: isi http://<server>. Pengaturan printer kiosk dan mode kiosk Chrome ada di kiosk/README.md.

Untuk display di monitor kedua sebuah PC (TV), jalankan display/scripts/start-display.bat di PC tersebut: display terbuka layar penuh di monitor tambahan. Lihat display/README.md.

Untuk tablet loket (Android, menghadap pelanggan), buka http://<server>/counter/ di Fully Kiosk Browser dan pilih loketnya di penyiapan; lihat counter-display/README.md.

Pemakaian sehari-hari

Jalankan perintah berikut di folder qentry:

Tugas	Perintah
Menyala setelah restart	Tidak perlu apa-apa: Qentry ikut menyala bersama Docker. Pastikan Docker menyala bersama PC: di Windows, atur Docker Desktop menyala saat login; di Linux, jalankan `sudo systemctl enable docker` sekali.
Menghentikan	`docker compose stop`
Menjalankan lagi	`docker compose start`
Melihat status	`docker compose ps`
Melihat log backend	`docker compose logs -f app`

Helper Matikan PC otomatis (tools/pc-shutdown, lihat kiosk/README.md) juga bisa dipasang di PC server itu sendiri, di luar Docker, tetapi tidak disarankan: mematikan server menghentikan semua layar.

Backup dan restore

Backup database (ganti <DB_USERNAME> dengan nilai di .env):

docker compose exec -T db pg_dump -U <DB_USERNAME> qentry > qentry-backup.sql

Restore ke Qentry yang sudah terpasang. Ini mengganti seluruh isi database saat ini:

docker compose stop app
docker compose exec -T db psql -U <DB_USERNAME> -d qentry -c "DROP SCHEMA public CASCADE; CREATE SCHEMA public;"
docker compose exec -T db psql -U <DB_USERNAME> qentry < qentry-backup.sql
docker compose start app

Gambar dan video yang diunggah ada di volume Docker qentry_assets. Salin keluar dengan:

docker compose cp app:/app/assets ./assets-backup

Simpan salinan .env bersama backup.

Memperbarui ke versi baru

Supplier Anda mengirim zip baru: qentry-windows.zip untuk server Windows, qentry-linux.zip untuk Linux.

Backup database (lihat Backup dan restore di atas).
Ekstrak zip baru menimpa folder qentry yang sudah ada, dan ganti file-filenya. .env dan data Anda tetap: zip tidak berisi .env, dan data tersimpan di Docker.
Jalankan Docker bila belum berjalan, lalu jalankan installer di folder qentry: klik dua kali install.bat di Windows, atau jalankan sudo ./install.sh di Linux.
Tunggu sampai muncul Qentry is running, lalu buka http://<server>/dashboard/ dan masuk. Start pertama setelah pembaruan bisa memakan waktu satu atau dua menit.

Layar, kiosk dan tablet tersambung kembali dengan sendirinya. Bila ada yang masih menampilkan versi lama, muat ulang halamannya.

Jangan ekstrak ke folder baru: installer tidak menemukan .env dan berhenti dengan No DB_PASSWORD in .env, but a Qentry database exists. Bila itu terjadi, salin .env dari folder qentry yang lama ke folder baru lalu jalankan installer lagi.

Lisensi

Ketentuan penggunaan ada di LICENSE dalam folder qentry (Bahasa Indonesia dan Inggris), dan komponen sumber terbuka tercantum di THIRD_PARTY_NOTICES.md.

Qentry dilisensikan untuk PC server ini. Saat lisensi berakhir, dashboard menampilkan Aktivasi Qentry dengan ID server ini, misalnya F0C0-5821-EA29-E23D, dan aplikasi lain menampilkan "Qentry is not licensed for this server".

Kirim ID itu ke supplier Qentry Anda. Anda akan menerima kunci lisensi baru.
Tempel kunci itu di dashboard lalu klik Aktifkan.

Kunci hanya berlaku di PC ini. Setelah pindah ke PC lain, mengganti motherboard atau menginstal ulang Windows, ID berubah dan Anda perlu kunci baru.

Mengatasi masalah

Masalah	Solusi
"Qentry is not licensed for this server", atau dashboard meminta lisensi	Lihat Lisensi di atas.
Tidak ada yang bisa dibuka setelah restart	Jalankan Docker (Windows: Docker Desktop; Linux: `sudo systemctl start docker`) dan tunggu satu menit.
Perangkat lain tidak bisa membuka aplikasi	Pakai alamat IP server, bukan `localhost`, dan izinkan koneksi masuk di port 80 pada firewall server. Bila alamat IP server berubah, kembalikan ke alamat tetapnya di router.
Pembaruan berhenti dengan `No DB_PASSWORD in .env, but a Qentry database exists`	Lihat Memperbarui ke versi baru: salin `.env` dari folder `qentry` yang lama, lalu jalankan installer lagi.
Pengguna lupa password	Company admin meresetnya di tab Pengguna dashboard.
Dashboard terbuka tetapi tidak ada yang bisa masuk	Kirim hasil `docker compose logs app` ke supplier Anda.
Masalah lain	Hubungi supplier Anda dengan apa yang terlihat dan hasil `docker compose ps`.