A. Pendahuluan

9Router adalah AI Gateway/OpenAI-Compatible Router yang memungkinkan berbagai AI tools seperti Codex, Claude Code, Cursor, Cline, dan lainnya menggunakan satu endpoint API dengan fitur auto-fallback antar provider AI. Setelah instalasi, layanan akan berjalan pada port 20128 secara default.

B. Minimum Requirement

• OS Linux (Ubuntu 22.04/24.04 direkomendasikan)
• Node.js 18+ atau 20+
• npm
• RAM minimal 2 GB
• Port 20128 terbuka pada firewall

C. Installasi via NPM

C.1. Install nodejs

Install nodejs menggunakan command berikut

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -

sudo apt install -y nodejs

Verifikasi setelah install nodejs, menggunakan command berikut

node -v
npm -v

C.2. Install 9router

Install 9router secara global, menggunakan command berikut 

npm install -g 9router

Tunggu hingga proses selesai.

C.3. Jalankan 9Router

Setelah install 9router selesai, dapat menjalankan 9router menggunakan command berikut 

9router

Tunggu hingga muncul pilihan interface berikut

Berikut untuk penjelasan terkait interface nya :

Pada saat instalasi atau pertama kali menjalankan 9Router, terdapat beberapa pilihan interface yang menentukan bagaimana aplikasi dijalankan dan diakses.

C.3.1. Web UI (Open in Browser)

Mode ini akan menjalankan 9Router dan langsung membuka dashboard berbasis web di browser.

Karakteristik : 

• Mengakses konfigurasi melalui browser.
• Terdapat dashboard visual untuk:
  • Menambah provider AI
  • Mengatur routing/fallback
  • Monitoring request
  • Mengelola API key
• Cocok untuk penggunaan sehari-hari.
• Biasanya diakses melalui:
  http://localhost:20128/dashboard
  atau
  http://IP-SERVER:20128/dashboard

Direkomendasikan untuk:

• VPS
• Server
• Pengguna umum
• Administrasi jangka panjang

C.3.2. Terminal UI (Interactive CLI)

Mode ini menjalankan antarmuka berbasis terminal (TUI/Text User Interface).

Karakteristik :

• Tidak menggunakan browser.
• Semua konfigurasi dilakukan dari terminal interaktif.
• Mirip aplikasi seperti:
  • htop
  • btop
  • nmtui

Biasanya terdapat menu navigasi menggunakan keyboard:

• Providers
• Models
• Routes
• Settings
• Logs

Kelebihan:

• Ringan.
• Tidak membutuhkan GUI/browser.
• Cocok untuk akses SSH.

Kekurangan:

• Kurang nyaman dibanding dashboard web.
• Fitur visual lebih terbatas.

Direkomendasikan untuk:

• Pengguna Linux SSH-only
• Server tanpa desktop environment
• Troubleshooting cepat

C.3.3. Hide to Tray (Background)

Mode ini menjalankan 9Router di background dan menyembunyikan jendela aplikasi ke system tray.

Karakteristik:

• Tidak membuka Web UI maupun Terminal UI.
• Proses tetap berjalan di background.
• Ikon aplikasi muncul di system tray/taskbar OS.
• Resource lebih hemat karena tidak menampilkan interface.

Biasanya digunakan pada:

• Windows Desktop
• Linux Desktop (GNOME/KDE)
• macOS

Tidak terlalu berguna untuk VPS/headless server, karena VPS umumnya tidak memiliki system tray.

Direkomendasikan untuk:

• Laptop/Desktop pribadi
• Workstation yang selalu aktif
• Pengguna yang tidak ingin jendela aplikasi terbuka terus

D. Verifikasi 9router

Setelah proses installasi, dapat mengakses 9router menggunakan localhost atau ip-server dengan port 20128. Seperti berikut

Nantinya dapat melakukan reset password, agar tidak menggunakan Default Password, untuk 9router.

Setelah set password baru, nantinya akan diarahkan ke Dashboard 9router, seperti berikut.

E. Penutup

9Router merupakan solusi AI Gateway yang memudahkan integrasi berbagai penyedia layanan AI melalui satu endpoint API yang kompatibel dengan OpenAI. Dengan proses instalasi yang relatif sederhana, baik melalui NPM maupun Docker, 9Router dapat diimplementasikan pada server Linux untuk mendukung berbagai kebutuhan integrasi AI seperti Open WebUI, Cursor, Cline, Claude Code, dan aplikasi lainnya.

Setelah instalasi selesai, administrator dapat mengelola provider AI, mengatur routing model, serta memantau penggunaan layanan melalui Web UI yang tersedia. Untuk lingkungan produksi, disarankan menjalankan 9Router sebagai service menggunakan systemd agar layanan dapat berjalan otomatis saat server melakukan reboot dan tetap aktif secara berkelanjutan.

Dengan konfigurasi yang tepat, 9Router dapat menjadi pusat manajemen akses AI yang fleksibel, efisien, dan mudah dikelola dalam satu platform terpusat.

Semoga artikel ini dapat membantu Anda. Temukan bantuan lainnya melalui Knowledge Base Biznet Gio. Jika Anda masih memiliki kendala silakan hubungi Support Biznet GIO melalui email support@biznetgio.com atau live chat maupun WA ke website www.biznetgio.com dan bisa juga melalui telepon ke nomor (021) 5714567.