Instalasi

Prasyarat

Node.js ≥ 20 (disarankan 22 LTS) + npm
Git
(Opsional) Docker + Docker Compose
Akses jaringan ke MikroTik / OLT / ACS bila fitur terkait dipakai

Cara 1 — Docker (disarankan)

git clone https://github.com/oxpoe/open-isp.git
cd open-isp
docker compose up -d

Buka http://localhost:3001. Login awal: admin / demo-isp123 — segera ganti password.

Data tersimpan di volume docker-data/:

docker-data/
├── settings.json     # konfigurasi (JANGAN di-commit)
├── database/         # billing.db (SQLite)
├── logs/
└── uploads/          # bukti bayar, QRIS, tiket

Cara 2 — Manual

git clone https://github.com/oxpoe/open-isp.git
cd open-isp
npm ci --omit=dev
cp env-example.txt .env      # opsional: isi MY_WEBHOOK_SECRET
npm start                    # entry point: app-customer.js

Mode pengembangan (auto-restart): npm run dev.

PM2 (daemon)

npm install -g pm2
pm2 start app-customer.js --name open-isp
pm2 save
pm2 startup     # ikuti instruksi agar autostart saat boot

Data demo (opsional, untuk uji coba)

node scripts/seed-demo.js

Menambahkan paket, area, 12 pelanggan contoh, tagihan, dan tiket. Login pelanggan demo: 081200000001 / demo-isp123.

Akses Portal

Port mengikuti server_port di settings.json (default 3001).

Portal	URL
Pelanggan	`http://SERVER:3001/customer/login` (alias `/login`)
Admin	`http://SERVER:3001/admin/login`
Teknisi	`http://SERVER:3001/tech/login`
Kolektor	`http://SERVER:3001/collector/login`
Health	`http://SERVER:3001/health`

Update Aplikasi

Docker: git pull lalu docker compose up -d --build.
Manual/PM2: git pull lalu pm2 restart open-isp.
Tersedia juga halaman Update GitHub di panel admin (menjalankan update + restart).

Selanjutnya: Konfigurasi.