---
title: "Tutorial Setup VPS Hermes: Install, Konfigurasi, dan Jalankan 24/7 di Background"
url: "https://helipod.io/blog/tutorial-setup-vps-hermes"
date: "2026-09-26"
updated: "2026-09-26"
author: "Tim Helipod"
tags: ["hermes-agent", "vps", "ai-agent", "tutorial", "linux", "hosting"]
excerpt: "Tutorial setup VPS Hermes Agent (Nous Research) di Ubuntu: instalasi, jalan 24/7 via systemd, dan cara aman mengaktifkan dashboard dan API."
---

# 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](https://helipod.io/vps-hermes)), 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](https://hermes-agent.nousresearch.com/docs) untuk perubahan terbaru.

## Daftar Isi

1. [Prasyarat](#1-prasyarat)
2. [Sewa & Akses VPS](#2-sewa--akses-vps)
3. [Update Sistem & Install Dependencies](#3-update-sistem--install-dependencies)
4. [Install Hermes Agent](#4-install-hermes-agent)
5. [Konfigurasi Awal (Setup Wizard)](#5-konfigurasi-awal-setup-wizard)
6. [Kenalan dengan File Konfigurasi](#6-kenalan-dengan-file-konfigurasi)
7. [Konfigurasi Firewall](#7-konfigurasi-firewall)
8. [Tes Chat Manual](#8-tes-chat-manual)
9. [Aktifkan Dashboard & API Server](#9-aktifkan-dashboard--api-server)
10. [Menjalankan Hermes di Background dengan systemd](#10-menjalankan-hermes-di-background-dengan-systemd)
11. [Keamanan: Jangan Expose Dashboard/API Sembarangan](#11-keamanan-jangan-expose-dashboardapi-sembarangan)
12. [Maintenance: Update, Log, Restart](#12-maintenance-update-log-restart)
13. [Troubleshooting Singkat](#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:

```bash
ssh root@ALAMAT_IP_VPS
```

## 3. Update Sistem & Install Dependencies

```bash
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:

```bash
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:

```bash
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:

```bash
hermes setup
```

Ada dua opsi:

- **Quick Setup (Nous Portal)**: login via OAuth
  ```bash
  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`:

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

terminal:
  backend: "local"
```

Cek konfigurasi:

```bash
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

| Port | Protocol | Keterangan |
|------|----------|------------|
| 22 | TCP | SSH (default, biasanya sudah terbuka) |
| 80 | TCP | HTTP (untuk web server/HAProxy) |
| 443 | TCP | HTTPS (untuk web server/HAProxy) |
| 9119 | TCP | Hermes Dashboard (opsional, lebih aman lewat SSH tunnel) |
| 8642 | TCP | Hermes API Server (opsional, lebih aman lewat SSH tunnel) |

### 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:
  ```bash
  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:

```bash
# 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:

```bash
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:

```bash
openssl rand -hex 32
```

Dashboard jalan di port `9119`, API di port `8642`.

## 10. Menjalankan Hermes di Background dengan systemd

Buat file service:

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

Isi:

```ini
[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:

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

**Alternatif tanpa systemd:**

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

atau pakai tmux:

```bash
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**:
   ```bash
   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:

```bash
hermes update
sudo systemctl restart hermes
```

Lihat log real-time:

```bash
journalctl -u hermes -f
```

Restart service:

```bash
sudo systemctl restart hermes
```

## 13. Troubleshooting Singkat

| Gejala | Penyebab | Solusi |
|--------|----------|--------|
| `hermes` menggantung lama | Belum ada provider dikonfigurasi | Jalankan `hermes setup` dulu |
| Dashboard tidak bisa diakses | Port belum dibuka / belum lewat SSH tunnel | Cek firewall & gunakan SSH tunnel |
| API selalu balik ke provider lama | Env var lama masih tersimpan | Cek isi `~/.hermes/.env` |
| Service mati setelah reboot | Belum `systemctl enable` | Jalankan `sudo systemctl enable hermes` |
| Config berubah tapi tidak efek | Salah taruh di file | Setting non-secret → `config.yaml`, secret → `.env` |

---

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](https://hermes-agent.nousresearch.com/docs).