Skip to content

Konfigurasi

Jump to bottom
oxpoe edited this page Oct 12, 2026 · 3 revisions

Konfigurasi

Semua pengaturan utama berada di settings.json (root proyek atau volume docker-data/). Sebagian bisa diubah dari panel admin; sebagian hanya di berkas.

Penting: settings.json, .env, dan database/ tidak boleh di-commit ke Git (sudah masuk .gitignore & .dockerignore).

Umum & Branding

Kunci Keterangan
company_header / company_name Nama perusahaan (tampil di UI, invoice, WhatsApp)
company_logo, logo_portal, logo_invoice Logo (path/URL)
project_url URL repositori proyek (dipakai di halaman landing/about)
app_url URL publik aplikasi (dipakai untuk link pada notifikasi/QRIS)
server_port, server_host Port & host server
default_lang Bahasa default (id / en)
timezone Zona waktu (mis. Asia/Jakarta)
session_secret Rahasia sesi — ganti dengan nilai acak

Aktivasi menu

Menu lanjutan bisa dikunci. Untuk membukanya dipakai kode aktivasi:

  • Kode tidak dipublikasikan di repo. Atur di settings.json:
    • activation_code — kode dalam bentuk teks (dipakai pada alur donasi/layanan untuk menampilkan & mengirim kode).
    • feature_password_hash — sha256 kode untuk validasi (opsional; default ada).
  • Contoh menghasilkan hash: 
    node -e "console.log(require('crypto').createHash('sha256').update('KODE-ANDA').digest('hex'))"
  • feature_contact_phone — nomor kontak yang ditampilkan pada menu terkunci.

Pada halaman Dukung OPEN-ISP (/donate) kode ditampilkan dari activation_code (bila diatur).

MikroTik

  • Multi-router: daftar router, tes koneksi, setup firewall, pemilihan router per pelanggan.
  • API standar port 8728; dukungan TLS/API-SSL port 8729 (self-signed diperbolehkan).
  • RouterOS 7 didukung (client API kompatibel).
  • Profil PPPoE/hotspot, sesi aktif, monitor trafik, jam kalong, FUP, voucher hotspot, backup konfigurasi.

OLT (PON)

  • Mendukung Hioso & HSGQ (SNMP) serta ZTE & Huawei (CLI/Telnet).
  • Isi host, community SNMP, port, merek, kredensial web/Telnet.
  • Aksi ONU: statistik, reboot, rename, otorisasi, konfigurasi WAN/OMCI.
  • Deteksi OLT baru: node scripts/olt-probe.js.

TR-069 (ACS bawaan & GenieACS)

  • ACS bawaan (tanpa server terpisah): set use_builtin_acs: true. Arahkan CPE ke http://IP-SERVER:PORT/acs.
  • Integrasi GenieACS eksternal juga didukung (REST API).

WhatsApp & Telegram

  • WhatsApp: pilih gateway GoWA (self-hosted), Fonnte, atau Meta Cloud API. Isi kredensial gateway sesuai pilihan.
  • Telegram: aktifkan bot & isi telegram_bot_token, telegram_admin_id.
  • Template pesan (tagihan, pengingat, struk) bisa diatur dari panel admin.

Pembayaran

  • QRIS statis + kode unik untuk pencocokan otomatis.
  • Webhook generik: POST /api/webhook/v1/payment-notif dengan header/secret MY_WEBHOOK_SECRET (di .env).
  • Gateway opsional: Midtrans / Tripay / Xendit / Duitku (sesuai konfigurasi).

Speed Test

  • Mode internal (backend LibreSpeed bawaan server di /speedtest/) atau eksternal (preset provider diatur admin).
  • Tampilan embed/tab; tersedia tombol Muat Ulang & Bersihkan Cache di portal pelanggan.

Email/SMTP (opsional)

Untuk notifikasi email (bila diaktifkan): isi host, port, user, password SMTP.

Selanjutnya: Panduan Admin.

Fitur Opsional

  • Voucher / Beli Voucher Wi-Fi — nyalakan/matikan lewat kunci voucher_enabled (Pengaturan → Fitur Opsional). Saat false, halaman voucher publik diblokir & link "Beli Voucher" disembunyikan. Default: aktif.

Clone this wiki locally