Skip to main content
Halaman ini untuk admin atau teknisi yang memasang JagaInd di server lokal. Cara yang didukung adalah Docker Compose dari repositori aplikasi JagaInd.

​
Sebelum mulai

  • Docker 24 atau lebih baru dengan Docker Compose v2.
  • Untuk server dengan GPU NVIDIA: driver NVIDIA dan NVIDIA Container Toolkit.
  • Untuk menyiapkan model AI: Python 3.11 atau lebih baru dan uv.
  • Salinan repositori aplikasi JagaInd.
  • Untuk produksi, gunakan server atau mini PC dengan GPU NVIDIA. Server tanpa GPU cocok untuk pengujian dan sedikit kamera.
  • Disk yang cukup untuk menyimpan foto bukti insiden.
  • Server berada di jaringan yang sama dengan kamera dan perangkat petugas.
  • Port TCP 8080 untuk dashboard.
  • Port UDP 40000–40050 untuk video langsung (WebRTC).

​
Langkah-langkah

1

Siapkan berkas konfigurasi

Di folder repositori aplikasi, salin contoh konfigurasi:
Lalu ubah nilai berikut di .env:
  • POSTGRES_PASSWORD: ganti kata sandi bawaan database.
  • JAGAIND_ADMIN_USERNAME dan JAGAIND_ADMIN_PASSWORD: akun admin pertama. Isi keduanya.
  • INFERENCE_BACKEND: untuk profil CPU, isi cpu, atau mock untuk mencoba tanpa model AI. Profil GPU selalu memakai gpu.
  • WHEP_NAT_IPS: alamat IP server yang dapat dijangkau peramban petugas, misalnya IP LAN server. Pisahkan beberapa alamat dengan koma.
Penjelasan semua variabel ada di Konfigurasi server.
2

Siapkan model AI

Untuk INFERENCE_BACKEND gpu atau cpu, model deteksi objek wajib ada di models/object_detection/model.onnx. Ekspor modelnya dengan:
Model tambahan dibutuhkan untuk modul tertentu:
  • Pengenalan Wajah butuh model deteksi dan embedding wajah. Unduh dengan make download-face-models MODEL=sface (hemat CPU) atau MODEL=auraface (butuh GPU).
  • Perundungan Fisik butuh model pose di models/yolo_pose/. Lihat docs/development/adding-models.md di repositori aplikasi.
3

Jalankan layanan

Pilih profil sesuai perangkat keras:
Docker Compose menjalankan database PostgreSQL, migrasi skema, Core, dan AI Worker.
4

Periksa status

Buka http://<alamat-server>:8080/healthz. Respons berisi "status":"HEALTHY" dan "ai_worker":"CONNECTED" bila semua berjalan.
5

Masuk sebagai admin

Buka http://<alamat-server>:8080, lalu masuk dengan JAGAIND_ADMIN_USERNAME dan JAGAIND_ADMIN_PASSWORD. Segera ganti kata sandi admin. Lihat Cara mengganti kata sandi.
Ganti semua kata sandi bawaan di .env sebelum server dipakai di lokasi. Jangan membagikan berkas .env karena berisi kata sandi dan token.

​
Hasil

Dashboard JagaInd dapat dibuka dari peramban di jaringan lokal, dan lampu Core serta Worker berwarna hijau. Lanjutkan ke Panduan cepat untuk admin.

​
Perintah operasional

Perubahan pada .env baru berlaku setelah layanan dimulai ulang.

​
Masalah umum

​
Lihat juga