Cara Setting Hermes Agent di VPS: 7 Langkah dari Install sampai Service Aktif

Cara setting Hermes Agent di VPS: install sebagai user non-root dengan skrip resmi, jalankan hermes setup, lalu isi TELEGRAM_ALLOWED_USERS sebelum gateway hidup. Sesudah bot menjawab, pasang gateway sebagai service sistem dengan sudo hermes gateway install --system, karena dokumentasi resmi menyarankan service sistem untuk VPS.

Hermes AgentAgent AIProgram AI yang mengerjakan langkah pekerjaan sendiri, misalnya membaca pesan, menyiapkan balasan, lalu mencatat hasilnya.Buka glosarium adalah AI agent open-source dari Nous Research. Agent ini berjalan di mesin Anda, menerima perintah dari terminal atau aplikasi chat, lalu memakai tool seperti terminal dan browser. Gateway adalah proses Hermes yang menghubungkan agent ke Telegram, Discord, Slack, WhatsApp, Signal, atau email.

Kami memeriksa dokumentasi dan halaman rilis resmi pada 1 November 2026. Versi terbaru saat itu adalah v0.22.5, rilis 22 Oktober 2026. Panduan ini menggantikan panduan install Hermes Agent di VPS dari April 2026, yang memakai URL installer lama.

Ringkasan 7 langkah setting Hermes Agent di VPS

Tabel ini memberi 1 perintah utama dan 1 hasil yang harus Anda lihat pada setiap langkah.

Langkah	Perintah utama	Hasil yang benar
1. User non-root	sudo adduser hermes	Anda bekerja sebagai user hermes, bukan root.
2. Install	curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash	hermes --version menampilkan versi.
3. Model	hermes setup	Agent menjawab 1 pertanyaan pendek di terminal.
4. Approval	hermes config set approvals.mode manual	Perintah berbahaya meminta persetujuan.
5. Allowlist	TELEGRAM_ALLOWED_USERS di ~/.hermes/.env	Bot hanya menjawab ID Telegram Anda.
6. Service	sudo hermes gateway install --system	Status service aktif.
7. Uji	hermes doctor, reboot, hermes update	Gateway hidup lagi sesudah reboot dan update.

Apa yang berubah sejak panduan April 2026?

Empat hal berubah: URL installer, versi Python, cara update memilih versi, dan aturan akses chat.

Hal	Sebelumnya	Sekarang, dokumentasi 1 November 2026
URL installer	raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh	https://hermes-agent.nousresearch.com/install.sh
Python	Panduan lama tidak menyebut versi.	Installer resmi memakai Python 3.14 lewat uv.
Update	Source install mengikuti branch main.	Sejak v0.22.0, hermes update mengikuti rilis stabil.
Akses chat	Aturan umum.	Allowlist per platform dan pairing DM. Tanpa allowlist, gateway menolak semua pengguna.

Hindari v0.22.1. Catatan rilis v0.22.2 menyebut v0.22.1 dibangun dari commit yang salah. Rilis v0.22.2 juga memperbaiki gateway di bawah systemd yang tidak mau start sesudah reboot.

Langkah 1: siapkan VPS dan user non-root

Pakai user biasa bernama hermes, karena dengan backend terminal local agent menjalankan perintah dengan hak akses user itu.

Untuk 2 channel harian, mulai dari 2 vCPU, 4 GB RAM, dan SSD 40 GB. Model tetap berjalan di provider APIAPIPintu resmi yang dipakai 2 sistem untuk saling mengirim data, tanpa orang menyalin data secara manual.Buka glosarium, bukan di VPS. Rincian 3 tier ada di artikel spesifikasi VPS untuk Hermes Agent.

sudo adduser hermes
sudo usermod -aG sudo hermes
sudo -iu hermes

Grup sudo hanya perlu untuk memasang service sistem pada langkah 6. Jangan beri user ini sudo tanpa password (NOPASSWD). Bila Anda memilih service user, lewati baris kedua.

Langkah 2: install Hermes Agent dengan skrip resmi

Jalankan skrip resmi sebagai user hermes, lalu muat ulang shell.

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
source ~/.bashrc
hermes --version

Skrip butuh Git, curl, tar, dan alat SHA-256. Skrip memasang uv, Python 3.14, Node.js, ripgrep, FFmpeg, dan Chromium. Kode masuk ke ~/.hermes/hermes-agent/, data ke ~/.hermes/, dan perintah hermes ke ~/.local/bin/.

Bila agent tidak memakai browser, tambahkan --skip-browser untuk menghemat disk.

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash -s -- --skip-browser

Langkah 3: pilih model provider dan simpan kunci API

Jalankan hermes setup, pilih 1 provider, lalu uji dengan 1 pertanyaan pendek.

hermes setup
hermes

Hermes menyimpan rahasia di ~/.hermes/.env dan pengaturan lain di ~/.hermes/config.yaml. Perintah hermes config set mengirim nama huruf besar, contoh OPENROUTER_API_KEY, ke .env secara otomatis.

hermes config set OPENROUTER_API_KEY sk-or-...
hermes config set model <provider/model>

Pakai 1 model dulu. Tambah fallback sesudah jalur utama stabil, agar sumber error mudah Anda lacak.

Langkah 4: atur approval dan backend terminal

Ubah approvals.mode ke manual untuk minggu pertama, agar setiap perintah berbahaya meminta persetujuan Anda.

hermes config set approvals.mode manual

Nilai	Perilaku
smart (bawaan)	Model bantu menilai risiko. Perintah risiko rendah lolos, perintah berbahaya ditolak, dan kasus ragu bertanya ke Anda.
manual	Setiap perintah berbahaya meminta persetujuan.
off	Semua cek mati, sama dengan --yolo. Jangan pakai di server bisnis.

Permintaan approval yang tidak Anda jawab dalam 300 detik ditolak. Cron dan mode tanpa pengawasan menolak perintah berbahaya secara bawaan.

Dokumentasi menyarankan backend kontainer, seperti docker, untuk gateway produksi. Backend ini memisahkan perintah agent dari sistem VPS. Dengan backend kontainer, Hermes melewati cek perintah berbahaya, karena kontainer menjadi batasnya.

docker version
hermes config set terminal.backend docker
hermes config set terminal.container_memory 2048

Batas memori kontainer bawaan adalah 5120 MB. Pada VPS 4 GB, turunkan batas itu, contoh ke 2048 MB.

Langkah 5: hubungkan Telegram dan kunci akses

Isi token bot dan ID angka Telegram Anda sebelum gateway hidup, karena gateway menolak semua pengguna bila allowlist kosong.

1. Buka @BotFather, kirim /newbot, lalu simpan token bot.
2. Kirim pesan ke @userinfobot untuk mendapat ID angka Anda.
3. Jalankan hermes gateway setup dan pilih Telegram, atau tulis 2 baris di ~/.hermes/.env.
4. Jalankan hermes gateway run di depan, lalu kirim pesan ke bot.

TELEGRAM_BOT_TOKEN=123456789:ABCdef...
TELEGRAM_ALLOWED_USERS=123456789

Pisahkan beberapa ID dengan koma. Jangan isi GATEWAY_ALLOW_ALL_USERS=true. Dokumentasi menyebut opsi ini tidak disarankan untuk bot dengan akses terminal.

Orang lain yang mengirim DM ke bot mendapat kode pairing 8 karakter. Kode berlaku 1 jam. Setujui hanya orang yang Anda kenal.

hermes pairing list
hermes pairing approve telegram <kode>
hermes pairing revoke telegram <user-id>

Untuk Discord, Slack, atau WhatsApp, pola allowlist sama. Baca perbandingan channel gateway Hermes Agent sebelum Anda menambah channel kedua.

Langkah 6: pasang gateway sebagai service systemd

Pasang gateway sebagai service sistem, karena dokumentasi resmi menyarankan service sistem untuk VPS dan host tanpa layar.

sudo hermes gateway install --system
sudo hermes gateway start --system
sudo hermes gateway status --system

Bila sudo menjawab command not found, sudo tidak membaca ~/.local/bin. Pakai path lengkap: sudo "$(command -v hermes)" gateway install --system.

Pilihan	Perintah	Cocok untuk
Service sistem	sudo hermes gateway install --system	VPS dan server tanpa layar. Ini saran dokumentasi.
Service user	hermes gateway install, lalu sudo loginctl enable-linger hermes	User hermes tanpa sudo. Linger menjaga service tetap hidup sesudah logout.

Baca log service user dengan journalctl --user -u hermes-gateway -f. Jangan pasang kedua jenis service sekaligus. Jangan tambah drop-in ExecStopPost, karena dokumentasi menyebut drop-in itu membuat loop restart.

Langkah 7: uji reboot, update, dan backup

Uji 3 kejadian sebelum tim memakai bot: reboot, update, dan pemulihan backup.

hermes doctor
hermes config check
sudo reboot
# sesudah login lagi
sudo hermes gateway status --system
hermes backup --quick
hermes update

Perintah hermes update menghentikan gateway selama update, lalu systemd menyalakannya lagi. Gateway menunggu pekerjaan yang berjalan sampai 30 menit sebelum restart. Selama jeda itu, bot tidak menjawab.

Rilis lama tidak dapat berjalan dengan state.db yang sudah ditulis gateway versi baru. Untuk kembali ke rilis lama, hentikan gateway, lalu pulihkan backup sebelum update dengan hermes import <backup.zip>. Contoh update yang memutus gateway ada di laporan bug self-update Hermes Agent 0.21.5.

Checklist validasi sesudah setting

Tandai setiap baris sebelum Anda memberi akses bot ke tim.

Uji	Cara	Hasil benar
Diagnosa	hermes doctor	Exit code 0, tidak ada masalah tersisa.
Versi	hermes --version	0.22.2 atau lebih baru.
Akses Anda	Kirim pesan dari ID di allowlist.	Bot menjawab.
Akses asing	Kirim pesan dari akun lain.	Bot mengirim kode pairing dan tidak mengerjakan tugas.
Approval	Dengan backend local, minta bot menghapus folder uji.	Bot meminta persetujuan.
Reboot	sudo reboot	Service aktif tanpa start manual.
Update	hermes update	Bot menjawab lagi sesudah update.

Tanya jawab

Berapa spesifikasi VPS untuk Hermes Agent?

Mulai dari 2 vCPU dan 2 GB RAM untuk uji coba 1 channel. Pakai 4 GB RAM untuk 2 channel harian, dan 8 GB untuk tim kecil dengan beberapa workflow.

Kenapa bot Telegram menjawab unauthorized?

ID angka Anda tidak ada di TELEGRAM_ALLOWED_USERS. Ambil ID dari @userinfobot, bukan username, lalu restart gateway.

Apa beda hermes gateway run dan hermes gateway install?

Perintah run menjalankan gateway di depan, dan gateway berhenti saat sesi SSH tutup. Perintah install memasang service latar yang hidup lagi sesudah reboot.

Versi Hermes Agent mana yang aman untuk VPS?

Pakai v0.22.2 atau lebih baru, karena v0.22.2 memperbaiki gateway systemd yang gagal start sesudah reboot. Lewati v0.22.1. Versi terbaru per 1 November 2026 adalah v0.22.5.

Apakah Hermes Agent boleh berjalan sebagai root?

Kami tidak menyarankannya. Dengan backend local, agent menjalankan perintah terminal dengan hak user gateway. Sebagai root, 1 perintah salah dapat mengubah seluruh server.

Kesimpulan operasional

Kerjakan 7 langkah ini secara berurutan, dan jangan hidupkan gateway sebelum allowlist terisi. Uji reboot dan update sebelum tim memakai bot. Bila Anda ingin setting ini selesai dengan SOP dan serah terima, lihat Jasa Install Hermes Agent.

Sumber

Kami membaca semua sumber ini pada 1 November 2026.

• Hermes Agent: Installation
• Hermes Agent: Configuration
• Hermes Agent: Security
• Hermes Agent: Messaging gateway
• Hermes Agent: Telegram
• Hermes Agent: Updating
• Hermes Agent: CLI commands
• Hermes Agent: rilis di GitHub