Dokumentasi

Panduan lengkap penggunaan ScanHadir

Instalasi Server Institusi

Mulai Cepat

Instalasi pada Server Institusi

Persiapan Sistem

Persyaratan Minimum

  • Sistem Operasi: Windows Server 2016 atau lebih baru
  • RAM: Minimum 4GB (disarankan 8GB)
  • Storage: 50GB free space
  • Koneksi: Internet stabil dengan bandwidth minimum 10 Mbps
  • Port: 8080 (HTTP), 443 (HTTPS), 3000 (API)

    • Download Pasanger

  • Download ScanHadirAPISetup.exe dari link yang diberikan
  • Pastikan file pasanger tidak corrupt dengan melakukan checksum

    • Proses Instalasi

    Penting

    Pastikan Domain yang ingin digunakan sebagai alamat server (Contoh: absensi.scanhadir.com) sudah terhubung ke Cloudflare

    class="text-primary underline underline-offset-4 hover:opacity-80 transition-opacity">Belum Melakukan Pemasangan Domain ke Cloudflare

    1. Menjalankan Pasanger

    Klik kanan pada file pasanger

    "Run as Administrator"

    2. Wizard Instalasi

    Installasi

    class="my-6 rounded-xl border border-border shadow-sm mx-auto md:w-[500px] md:h-[500px] w-[90%]"

    loading="eager" decoding="async" style="object-fit:cover;" />

  • Masukan beberapa data yang di butuhkan seperti Nama Institusi, Alamat Server (Contoh: absensi.scanhadir.com), Koordinat Institusi, Username dan Password Admin, Label Masuk (id/username), Opsi Izin dan Opsi Jabatan
  • Pilih lokasi instalasi (default: C:\Program Files\ScanHadir Setup)
  • Pastikan Jalankan Skrip Pemasangan (Penting) di centang
  • Lalu Finish
  • Program akan Berjalan melakukan Pemasangan
  • Setelah Pemasangan Selesai anda di minta untuk Masuk ke akun Cloudflare, lalu pilih Domain yang ingin anda jadikan subdomain untuk alamat server nanti (Contoh: scanhadir.com)
  • Setelah itu anda di minta untuk Memasukan Alamat Server, pastikan alamat server yang anda masukan itu sama dengan form yang anda isi saat pasangasi (Contoh: absensi.scanhadir.com)
  • Selesai
  • Setelah itu

    class="text-primary underline underline-offset-4 hover:opacity-80 transition-opacity">Lakukan Konfigurasi cloudflared sebagai Service di Windows melalui Registry

    Konfigurasi Lokasi Kantor

    Set GPS Coordinates:

  • Pada kolom Koordinat Institusi
  • Input koordinat GPS kantor utama (Contoh):

    • - Latitude: -6.200000

    - Longitude: 106.816666

  • Add multiple locations untuk cabang (Contoh: [-7.250445,112.768845], [-7.250445,112.768455])

    • Mendapatkan Koordinat class="my-6 rounded-xl border border-border shadow-sm mx-auto md:w-[300px] w-[90%]"

    loading="eager" decoding="async" style="object-fit:cover;" />

    Cara Mendapatkan Koordinat Institusi:

  • Buka Google Maps
  • Cari Alamat Institusi anda
  • Klik kanan
  • Saling Koordinat

    • 3. Konfigurasi Task Scheduler

    Setup Auto-Start pada Windows

  • Buka Task Scheduler Windows (taskschd.msc)
  • Klik "Create Basic Task" di panel Actions
  • Konfigurasi sebagai berikut:

    • - Name: ScanHadir AutoStart

    - Description: Isi sesuai keinginan

    Trigger Settings

  • When do you want the task to start?: When the computer starts
  • What action do you want the task to perform?: Start a program

    • Start a Program:

  • Program/script: cari file app.services.ps1 di lokasi tempat anda memilih lokasi instalasi (default: C:\Program Files\ScanHadir Setup\ScanHadir_Service)

    • Hasilnya seperti ini:

    "C:\Program Files\ScanHadir Setup\ScanHadir_Service\app.services.ps1"
  • Start in (optional): isi dengan lokasi ScanHadir_Service (default: C:\Program Files\ScanHadir Setup\ScanHadir_Service)

    • Hasilnya seperti ini:

    C:\Program Files\ScanHadir Setup\ScanHadir_Service

    Simpan Task

    tekan tombol Finish untuk menyimpan task

    Jalankan Sebagai Admin dan Mulai saat Komputer / Server aktif

    Pada list Task yang ada, pilih task yang sebelumnya sudah di buat

    Task Scheduler class="my-6 rounded-xl border border-border shadow-sm mx-auto md:w-[300px] w-[80%]"

    loading="eager" decoding="async" style="object-fit:cover;" />

    Lalu Klik Kanan lalu pilih Properties

    Security options

  • Pilih Run whether user is logged on or not
  • Centang ✅ Run with highest privileges

    • Hasilnya seperti ini:

    Properties class="my-6 rounded-xl border border-border shadow-sm mx-auto md:w-[300px] w-[80%]"

    loading="eager" decoding="async" style="object-fit:cover;" />

    lalu tekan OK

    Masuk untuk menyimpan perubahan

    anda akan di minta untuk memasukan password untuk menjalankan task ScanHadir

    isi password lalu tekan OK

    Penting

    pastikan komputer / server memiliki password

    Verifikasi Instalasi

    1. Akses Web Interface

  • Buka browser dan akses: http://localhost:3000
  • Atau dari komputer lain: http://[server-ip]:3000

    • 4. Test Functionality

  • Buka Aplikasi ScanHadir Dashboard yang sudah di Pasang di Komputer
  • Buat user test
  • Test scanning functionality (Pakai Aplikasi ScanHadir Scanner)