Tutorial Setup VPS Hermes: Install, Konfigurasi, dan Jalankan 24/7 di Background

Hermes Agent adalah AI agent open-source dari Nous Research yang bisa jalan mandiri di server — punya memory yang persisten, bisa dihubungkan ke Telegram/Discord/Slack/WhatsApp, dan mendukung 200+ model LLM (OpenRouter, Anthropic, OpenAI, atau endpoint custom).

Tutorial ini menjelaskan cara install Hermes Agent di VPS Ubuntu (misalnya VPS Hermes dari Helipod), mengonfigurasinya lewat file config, lalu menjalankannya sebagai background service yang tetap hidup walau kamu logout atau server restart.

Catatan: Hermes Agent adalah proyek open-source pihak ketiga (bukan produk Anthropic/Claude). Selalu cek dokumentasi resmi di hermes-agent.nousresearch.com/docs untuk perubahan terbaru.

Daftar Isi

1. Prasyarat
2. Sewa & Akses VPS
3. Update Sistem & Install Dependencies
4. Install Hermes Agent
5. Konfigurasi Awal (Setup Wizard)
6. Kenalan dengan File Konfigurasi
7. Konfigurasi Firewall
8. Tes Chat Manual
9. Aktifkan Dashboard & API Server
10. Menjalankan Hermes di Background dengan systemd
11. Keamanan: Jangan Expose Dashboard/API Sembarangan
12. Maintenance: Update, Log, Restart
13. Troubleshooting Singkat

1. Prasyarat

• VPS dengan Ubuntu 22.04/24.04, minimal 2 vCPU / 2GB RAM / 40GB SSD
• Akses root atau user dengan sudo
• SSH client (Terminal di Mac/Linux, atau PuTTY/Windows Terminal di Windows)
• Salah satu dari: akun Nous Portal, atau API key sendiri (OpenAI, Anthropic, OpenRouter, dll)

2. Sewa & Akses VPS

Kalau pakai VPS Hermes dari Helipod, setelah order kamu akan dapat:

• Alamat IP VPS
• Username (biasanya root atau ubuntu)
• Password atau SSH key

Login via SSH:

ssh root@ALAMAT_IP_VPS

3. Update Sistem & Install Dependencies

sudo apt update && sudo apt upgrade -y
sudo apt install -y curl git build-essential

4. Install Hermes Agent

Gunakan installer resmi dari repo NousResearch:

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Tips keamanan: sebelum menjalankan script lewat curl | bash, ada baiknya buka dulu URL-nya di browser untuk melihat isinya.

Setelah instalasi selesai:

source ~/.bashrc
hermes --version

5. Konfigurasi Awal (Setup Wizard)

Jangan langsung jalankan hermes sebelum konfigurasi provider — tanpa provider yang jelas, Hermes akan mencoba auto-detect kredensial yang bisa bikin proses menggantung lama.

Jalankan wizard setup:

hermes setup

Ada dua opsi:

• Quick Setup (Nous Portal) — login via OAuth

  hermes setup --portal
  

• Full Setup — pilih sendiri provider dan API key

6. Kenalan dengan File Konfigurasi

Semua pengaturan Hermes Agent disimpan di folder ~/.hermes/:

~/.hermes/
├── config.yaml     # Pengaturan utama (model, terminal, dashboard)
├── .env            # API key & secret
├── auth.json       # Token OAuth
├── SOUL.md         # Persona/kepribadian agent (opsional)
├── memories/       # Memory persisten antar sesi
├── skills/         # Skill yang dibuat agent
├── cron/           # Jadwal tugas terjadwal
└── logs/           # Log aplikasi

Contoh isi config.yaml:

model:
  default: "anthropic/claude-sonnet-4"
  provider: "custom"
  base_url: "https://api.provider-kamu.com/v1"

terminal:
  backend: "local"

Cek konfigurasi:

hermes config check

7. Konfigurasi Firewall

Sebelum menjalankan Hermes, pastikan firewall VPS sudah dikonfigurasi dengan benar. Di Helipod, kamu bisa mengatur firewall langsung dari dashboard VPS → tab Firewall.

Port yang Perlu Dibuka

Cara Konfigurasi di Dashboard Helipod

1. Buka dashboard VPS → tab Firewall
2. Klik Add Rule
3. Gunakan Quick Presets untuk port umum (SSH, HTTP, HTTPS)
4. Atau masukkan manual:
   • Protocol: TCP
   • Port Range: 9119 (untuk dashboard)
   • Direction: Inbound
   • Action: Allow
   • CIDR Block: 0.0.0.0/0 (atau IP spesifik untuk keamanan lebih)
5. Klik Add Custom Rule

Tips Keamanan Firewall

• Jangan buka port 9119/8642 ke publik kecuali benar-benar perlu
• Gunakan SSH tunnel untuk akses dashboard dari komputer lokal:

  ssh -L 9119:127.0.0.1:9119 -L 8642:127.0.0.1:8642 ubuntu@ALAMAT_IP_VPS
  

• Batas akses dengan CIDR — misalnya hanya IP kantor kamu (192.168.1.0/24)

Alternatif: Konfigurasi via Command Line

Kalau lebih suka command line, kamu bisa konfigurasi firewall di dalam VPS:

# UFW (Ubuntu)
sudo ufw allow 22/tcp
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw allow 9119/tcp
sudo ufw allow 8642/tcp
sudo ufw enable

8. Tes Chat Manual

Sebelum lanjut ke background service, pastikan agent jalan normal:

hermes

Kalau berhasil, kamu akan masuk ke TUI interaktif. Tekan Ctrl+C untuk keluar.

9. Aktifkan Dashboard & API Server

Tambahkan baris berikut ke ~/.hermes/.env:

HERMES_DASHBOARD=1
HERMES_DASHBOARD_BASIC_AUTH_USERNAME=username_kamu
HERMES_DASHBOARD_BASIC_AUTH_PASSWORD=password_yang_kuat

API_SERVER_ENABLED=1
API_SERVER_KEY=token_acak_yang_panjang

Generate token acak:

openssl rand -hex 32

Dashboard jalan di port 9119, API di port 8642.

10. Menjalankan Hermes di Background dengan systemd

Buat file service:

sudo nano /etc/systemd/system/hermes.service

Isi:

[Unit]
Description=Hermes Agent Gateway
After=network.target

[Service]
Type=simple
User=ubuntu
WorkingDirectory=/home/ubuntu
EnvironmentFile=/home/ubuntu/.hermes/.env
ExecStart=/home/ubuntu/.local/bin/hermes gateway run
Restart=on-failure
RestartSec=5

[Install]
WantedBy=multi-user.target

Aktifkan dan jalankan:

sudo systemctl daemon-reload
sudo systemctl enable hermes
sudo systemctl start hermes
sudo systemctl status hermes

Alternatif tanpa systemd:

nohup hermes gateway run > ~/.hermes/logs/gateway.out 2>&1 &

atau pakai tmux:

tmux new -s hermes
hermes gateway run
# Ctrl+B lalu D untuk detach

11. Keamanan: Jangan Expose Dashboard/API Sembarangan

VPS kamu punya IP publik, jadi jangan buka port 8642/9119 ke publik tanpa autentikasi.

Rekomendasi:

1. Set autentikasi dashboard (sudah dilakukan di langkah 9)
2. Jangan buka firewall untuk port 8642/9119 kecuali perlu
3. Akses lewat SSH tunnel:

   ssh -L 9119:127.0.0.1:9119 -L 8642:127.0.0.1:8642 ubuntu@ALAMAT_IP_VPS
   

4. Kalau harus expose ke publik, taruh di belakang reverse proxy (Nginx) dengan HTTPS

12. Maintenance: Update, Log, Restart

Update ke versi terbaru:

hermes update
sudo systemctl restart hermes

Lihat log real-time:

journalctl -u hermes -f

Restart service:

sudo systemctl restart hermes

13. Troubleshooting Singkat

Selesai! Hermes Agent kamu sudah jalan 24/7 di VPS sebagai background service. Untuk fitur lanjutan (integrasi Telegram/Discord/WhatsApp, cron job, MCP server), cek dokumentasi resmi di hermes-agent.nousresearch.com/docs.