Ikhtisar Instalasi

NQRust-Identity Portal Installer adalah tool berbasis terminal yang men-deploy stack NQRust-Identity pada server Linux. Instalasi dilakukan dalam dua fase melalui text user interface yang terpandu.

Yang akan terinstal

Installer men-deploy dua service sebagai Docker container:

• Identity — provider OIDC/OAuth2 untuk autentikasi dan otorisasi.
• Portal — aplikasi web untuk manajemen lisensi dan administrasi.

Kedua service dikonfigurasi dengan HTTPS secara default.

Prasyarat

Persyaratan sistem

• Server Linux (disarankan Ubuntu 24.04 LTS)
• Akses sudo
• 15–40 GB ruang disk kosong
• Hostname atau IP statis yang dapat dijangkau pengguna

Persyaratan software

• Docker Engine terinstal dan berjalan
• Docker Compose v2 (perintah docker compose)

File installer

Installer beroperasi dalam mode airgapped. Semua Docker image yang dibutuhkan sudah dibundel ke dalam satu binary self-extracting, sehingga tidak diperlukan akses internet saat instalasi.

Dua file yang dibutuhkan:

Verifikasi installer

Letakkan kedua file di direktori yang sama pada server, lalu verifikasi checksum-nya:

sha256sum -c nqrust-portal-airgapped.sha256

Output yang diharapkan:

nqrust-portal-airgapped: OK

Jadikan binary dapat dieksekusi

chmod +x nqrust-portal-airgapped

Jalankan installer

Jalankan installer dari direktori tempat file konfigurasi (.env, docker-compose.yaml) akan dibuat:

./nqrust-portal-airgapped

Pada peluncuran pertama, installer memuat Docker image yang dibundel ke dalam Docker daemon lokal. Proses ini dapat memakan waktu beberapa menit.

Alur instalasi

Instalasi dibagi menjadi dua fase. Selesaikan secara berurutan:

1. Fase 1: Instalasi Identity — Konfigurasi port dan deploy container Identity dan Portal.
2. Fase 2: Konfigurasi Portal — Buat OAuth client di Identity dan hubungkan ke Portal.