Akses Dashboard Hermes via SSH Port Forwarding

Kenapa Perlu Dashboard?

Hermes Agent biasanya dioperasikan lewat CLI di terminal atau via bot Telegram/Discord. Tapi ada kalanya kamu butuh antarmuka visual untuk:

• Mengelola konfigurasi provider dan model
• Melihat daftar session yang aktif
• Memonitor cron job yang berjalan
• Mengatur API key secara visual

Hermes Agent menyediakan web dashboard yang bisa dijalankan langsung dari terminal VPS. Dashboard ini berupa aplikasi web FastAPI + Uvicorn yang berjalan di localhost.

Masalahnya, VPS biasanya tidak memiliki desktop browser. Solusinya: SSH port forwarding — terowongan aman yang membawa traffic dari browser lokal ke dashboard di VPS tanpa perlu membuka port ke internet.

Tutorial ini fokus pada metode SSH tunnel menggunakan Termius, karena itulah yang paling aman dan relevan untuk akses dari HP.

Prasyarat

Sebelum memulai, pastikan hal berikut sudah tersedia:

• VPS dengan Hermes Agent terinstall
• SSH key atau password untuk login ke VPS
• Termius terinstall di HP atau laptop
• Browser di perangkat yang sama dengan Termius

Step 1: Install Dependencies Dashboard

Secara default, Hermes Agent tidak menyertakan dependencies web dashboard untuk menghemat ruang. Kamu perlu menginstallnya secara terpisah.

SSH ke VPS, lalu jalankan:

pip install hermes-agent[web]

Perintah ini menginstall FastAPI, Uvicorn, dan library pendukung lainnya.

Verifikasi installasi dengan mengecek apakah perintah hermes dashboard bisa diakses:

hermes dashboard --help

Output yang diharapkan:

Usage: hermes dashboard [options]

Launch the web dashboard — a browser-based UI for managing configuration,
API keys, and monitoring sessions.

Step 2: Jalankan Dashboard di VPS

Dashboard berjalan di VPS dan mendengarkan koneksi di port tertentu. Secara default, Hermes dashboard hanya terikat ke 127.0.0.1 (localhost) — artinya hanya proses di VPS yang bisa mengaksesnya.

Jalankan dashboard:

hermes dashboard

Output yang muncul:

Dashboard running at http://127.0.0.1:9119

Biarkan terminal ini tetap terbuka. Dashboard akan terus berjalan selama proses ini aktif.

Step 3: Setup Port Forwarding di Termius

Ini adalah langkah paling penting. Kamu akan membuat terowongan SSH dari perangkat lokal ke VPS.

1. Buka Termius, tap koneksi SSH VPS kamu
2. Tap Settings (ikon roda gigi)
3. Tap Port Forwarding
4. Tap Add New
5. Isi dengan nilai berikut:

6. Simpan dan kembali ke layar utama
7. Tap koneksi untuk SSH login seperti biasa

Setelah SSH berhasil login, Termius secara otomatis membuat terowongan. Kamu bisa membiarkan Termius tetap terkoneksi — port forwarding aktif selama sesi SSH aktif.

Step 4: Buka Dashboard di Browser

Buka browser di perangkat yang sama dengan Termius, lalu akses:

http://localhost:9119

Jika semua langkah benar, kamu akan melihat dashboard Hermes dengan antarmuka web yang menampilkan:

• Informasi sistem dan versi Hermes
• Konfigurasi provider dan model
• Daftar session
• Status cron job

Step 5: Jalankan Dashboard di Background

Agar dashboard tidak mati saat terminal SSH ditutup, kamu bisa menjalankannya di background menggunakan nohup atau screen.

Menggunakan nohup:

nohup hermes dashboard --no-open > ~/.hermes/dashboard.log 2>&1 &

Menggunakan screen:

screen -S hermes-dashboard
hermes dashboard --no-open
# Tekan Ctrl+A, lalu D untuk detach

Untuk kembali ke session screen:

screen -r hermes-dashboard

Konfigurasi Tambahan

Dashboard memiliki beberapa opsi yang bisa disesuaikan:

Mengganti port (misal port 8080 karena 9119 sudah dipakai):

hermes dashboard --port 8080 --no-open

Sesuaikan port forwarding di Termius menjadi:

Kemudian akses http://localhost:8080 di browser.

Akses dari perangkat berbeda (misal dashboard jalan di VPS, browser di HP):

Pastikan Termius berjalan di HP (bukan laptop). Port forwarding bekerja dari mana saja selama Termius terkoneksi ke VPS.

Ringkasan

Yang didapatkan dari tutorial ini:

• Dashboard Hermes — antarmuka web untuk mengelola konfigurasi dan session
• SSH port forwarding — akses aman tanpa buka port ke internet
• Termius integration — port forwarding dari HP tanpa perlu terminal command line
• Background service — dashboard tetap jalan meskipun SSH terputus

Dengan kombinasi dashboard + port forwarding, kamu bisa mengelola Hermes Agent secara visual dari mana saja, cukup bermodalkan koneksi SSH dan browser.