Jawaban langsung: pasang Hermes AgentAgent AIProgram AI yang mengerjakan langkah pekerjaan sendiri, misalnya membaca pesan, menyiapkan balasan, lalu mencatat hasilnya.Buka glosarium di VPS Ubuntu 24.04 sebagai user non-root dengan 1 perintah curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash, periksa dengan hermes doctor, sambungkan penyedia model, kunci approvals dan allowlist, lalu pasang gateway sebagai layanan dengan hermes gateway install plus sudo loginctl enable-linger. Urutan ini membuat agent hidup setelah reboot tanpa akses root harian.

Kondisi utama: panduan ini untuk Ubuntu 22.04 atau 24.04 di VPS dengan systemd, 1 user non-root yang punya sudo, dan koneksi ke GitHub. Batas: di dalam container Docker, hermes gateway install menolak memasang layanan user dan meminta hermes gateway run dengan restart policy container. Panduan ini tidak membahas Windows, macOS, atau Termux; untuk itu baca panduan install Hermes Agent di Windows dan panduan install Hermes Agent di macOS.

Kami menjalankan seluruh urutan ini pada 19 September 2026 di container Ubuntu 24.04.5 sebagai user hermes tanpa root, dengan Hermes Agent v0.21.3 (2026.9.14). Semua tangkapan layar terminal berasal dari uji itu. Nama host disamarkan. Dokumentasi Installation, Platform Support, Security, dan Messaging Gateway kami baca pada hari yang sama.

Masalah: install 1 baris berhasil, 3 hari kemudian agent mati

Perintah install Hermes memang 1 baris. Yang membuat agent mati diam-diam adalah 4 hal sesudahnya: gateway yang berhenti saat Anda logout, kunci APIAPIPintu resmi yang dipakai 2 sistem untuk saling mengirim data, tanpa orang menyalin data secara manual.Buka glosarium yang ditaruh sembarangan, allowlist * yang membuka bot ke semua orang, dan update yang tidak pernah dijalankan. Artikel ini menutup kueri "install hermes agent ubuntu" yang pada Search Console kami sudah tampil tanpa panduan langkah demi langkah yang diuji. Gambaran umum urutan setup yang aman kami tulis lebih dulu pada artikel urutan setup Hermes Agent di VPS; artikel ini versi yang dijalankan dan dicatat outputnya.

Diagram 6 titik periksa install Hermes Agent di VPS Ubuntu: siapkan VPS, install.sh, periksa, sambungkan model, kunci akses, jadikan layanan
6 titik periksa yang dirinci menjadi 10 langkah di bawah. (1) Siapkan VPS. (2) Jalankan install.sh. (3) Periksa. (4) Sambungkan model. (5) Kunci akses. (6) Jadikan layanan. Strip bawah menyebut cara verifikasi dan 1 batas dari uji kami.

Cara kerja instalasi Hermes di Ubuntu

Tata letak: per-user atau root

Dijalankan sebagai user biasa, installer menaruh kode di ~/.hermes/hermes-agent/, perintah hermes sebagai symlink di ~/.local/bin/hermes, dan data di ~/.hermes/. Dijalankan sebagai root dengan sudo bash, installer memakai tata letak FHS: kode di /usr/local/lib/hermes-agent/, perintah di /usr/local/bin/hermes, data di /root/.hermes/. Untuk VPS 1 tim, kami memakai per-user supaya kredensial tiap orang terpisah. Sumber: dokumentasi Installation, bagian Install Layout, 19 September 2026.

Yang dipasang installer

Installer memeriksa dan memasang uv, Python 3.11 lewat uv bila Python sistem tidak memenuhi syarat, Node.js 26 bila belum ada Node 22.22 atau lebih baru, ripgrep, dan ffmpeg. Pada uji kami, Python 3.12.3 bawaan Ubuntu dipakai langsung, Node.js 26.9.0 gagal dibaca lalu installer turun ke Node.js 24.21.0, dan installer memasang build-essential lewat apt untuk modul native. Prasyarat satu-satunya adalah git; di Linux tambahkan curl dan xz-utils.

Gateway sebagai layanan: user service plus linger

Dokumentasi memberi 2 pilihan di Linux. Layanan user lewat hermes gateway install berhenti saat logout, kecuali Anda mengaktifkan lingering dengan sudo loginctl enable-linger $USER 1 kali. Layanan sistem lewat sudo hermes gateway install --system hidup saat boot tanpa linger. Dokumentasi menyarankan user service untuk laptop dan system service untuk VPS headless, dengan catatan bahwa user service plus linger memberi hasil yang sama tanpa root. Sumber: dokumentasi Messaging Gateway, bagian Service Management.

Bawaan keamanan yang sudah aktif

Instalasi baru memakai approvals.mode: smart, timeout 300 detik yang menolak prompt tanpa jawaban, blocklist keras untuk perintah seperti rm -rf /, pemblokiran tulis ke ~/.ssh/ dan berkas .env, dan redaksi rahasia pada output. Gateway menolak semua pengguna tanpa allowlist atau pairing. Sumber: panduan Running Hermes on a Personal or Work Machine.

3 cara pasang di Linux menurut dokumentasi

CaraStatus dukunganCocok untukCara update
install.sh per-userTier 1VPS 1 tim, laptop Linux, WSL2hermes update
install.sh sebagai rootTier 1Mesin bersama, image serverhermes update
Container DockerTier 1Deploy terkelola, orkestrasiTarik image baru; hermes update tidak didukung
Nix dan NixOSTier 2Pengguna Nix yang sudah adaPerbarui flake
pip, brew, AURTidak didukungJangan dipakaiPindah ke install.sh

Sumber: halaman Platform Support, 19 September 2026.

Prasyarat

  • VPS Ubuntu 22.04 atau 24.04 dengan systemd. Dokumentasi Team Telegram Assistant menyebut VPS $5 per bulan memadai untuk gateway. Pada uji kami, folder ~/.hermes memakai 2,3 GB setelah install, termasuk clone git 1,2 GB.
  • Akses SSH sebagai user dengan sudo. Root hanya untuk 4 perintah: apt, adduser, usermod, dan loginctl.
  • Koneksi ke GitHub dan npm registry. Pada uji kami, clone dari GitHub berjalan 50 KB per detik di 1 jaringan; siapkan waktu 10 sampai 30 menit.
  • 1 akun penyedia model: Nous Portal, OpenRouter, Anthropic, OpenAI, atau server Ollama.
  • 1 token bot Telegram atau 1 nomor WhatsApp khusus untuk gateway.
  • 1 tugas nyata untuk uji pertama.

Langkah 1: Siapkan VPS dan user non-root

Masuk lewat SSH sebagai user dengan sudo. Perbarui paket, pasang 3 prasyarat, buat user hermes, beri sudo, lalu pindah ke user itu.

sudo apt update && sudo apt install -y curl git xz-utils
sudo adduser hermes
sudo usermod -aG sudo hermes
su - hermes
Terminal menampilkan hermes --version dengan keluaran Hermes Agent v0.21.3, install directory, install method git, Python 3.12.3, dan Up to date
Keluaran hermes --version pada uji kami setelah Langkah 3. (1) Versi v0.21.3 (2026.9.14) dan commit upstream. (2) Status Up to date. Perintah ini menjadi bukti bahwa Langkah 1 sampai 3 berhasil.

Verifikasi: whoami mengembalikan hermes, git --version mengembalikan 2.43 atau lebih baru, dan sudo -n true berjalan tanpa error. Sumber: bagian Prerequisites dan Non-Sudo Installs.

Langkah 2: Jalankan install.sh

Jalankan perintah resmi. Bila VPS headless dan Anda tidak butuh browser automation, tambahkan --skip-browser supaya Playwright dan Chromium tidak dipasang; ini menghemat ratusan MB dan menghindari langkah apt tambahan.

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

Versi headless:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash -s -- --skip-browser --skip-computer-use
Terminal menampilkan banner Hermes Agent Installer, deteksi Ubuntu, uv, Python, Git, unduhan Node.js, dan pemasangan build-essential
Awal instalasi pada uji kami. (1) Deteksi linux (ubuntu) dan pemasangan uv terkelola. (2) Node.js 26 gagal dibaca lalu installer mengunduh Node.js 24.21.0. (3) Peringatan koneksi ke duckduckgo.com gagal; install tetap lanjut.

Verifikasi: baris Repository ready muncul setelah clone, lalu uv menyelesaikan 259 paket pada uji kami. Bila clone terhenti lama, cek curl -sI https://github.com dari VPS; jaringan yang lambat ke GitHub adalah penyebab utama.

Langkah 3: Selesaikan instalasi dan muat ulang shell

Di akhir, installer menyinkronkan skill bawaan, menampilkan kotak Installation Complete, dan meminta Anda memuat ulang shell.

Terminal menampilkan Done 58 new skills, kotak Installation Complete, lokasi berkas, daftar perintah, dan instruksi source ~/.bashrc
Akhir instalasi pada uji kami. (1) 58 skill bawaan disinkronkan. (2) Lokasi config.yaml, .env, data, dan kode. (3) Perintah source ~/.bashrc. Wizard setup dilewati karena kami memakai --skip-setup; jalankan hermes setup di Langkah 6.
source ~/.bashrc
hermes --version

Verifikasi: hermes --version mengembalikan versi, jalur install, dan Up to date. Bila muncul hermes: command not found, tambahkan export PATH="$HOME/.local/bin:$PATH" ke ~/.bashrc. Sumber: tabel Troubleshooting pada dokumentasi Installation.

Langkah 4: Jalankan hermes doctor

Perintah ini memeriksa advisory keamanan, SQLite, paket wajib, berkas konfigurasi, provider, folder, alat eksternal, dan konektivitas API dalam 1 laporan.

hermes doctor
Keluaran hermes doctor dengan Security Advisories, Python Environment, Required Packages, Configuration Files, dan Auth Providers
hermes doctor pada uji kami. (1) Tidak ada advisory keamanan aktif. (2) Peringatan SQLite 3.45.1 dari paket Ubuntu dengan tautan penjelasan. (3) Peringatan provider belum login, wajar sebelum Langkah 6.

Verifikasi: tidak ada baris merah. Peringatan kuning python-telegram-bot dan discord.py hilang setelah Anda memilih platform di Langkah 8. Peringatan Config version outdated diperbaiki dengan hermes config migrate.

Langkah 5: Periksa alat eksternal dan tool yang aktif

Bagian bawah laporan doctor menyebut alat eksternal dan daftar tool yang tersedia untuk agent. Di sini Anda tahu apa yang hilang karena --skip-browser.

Keluaran hermes doctor bagian External Tools, API Connectivity, dan Tool Availability
Lanjutan doctor pada uji kami. (1) Playwright Chromium belum terpasang karena --skip-browser; tool browser_* disembunyikan dari agent. (2) Daftar tool aktif: browser-use, clarify, code_execution, cronjob, delegation, file, memory.

Verifikasi: tool cronjob, file, dan memory tampil. Bila nanti butuh browser, jalankan cd ~/.hermes/hermes-agent && npx playwright install --with-deps chromium seperti yang disarankan doctor; langkah --with-deps butuh sudo.

Langkah 6: Sambungkan penyedia model

Jalur A untuk 1 login: hermes setup --portal. Di VPS tanpa browser, OAuth butuh port forwarding: jalankan ssh -L dari laptop ke VPS sesuai panduan OAuth over SSH, lalu buka tautan login di browser laptop. Jalur B untuk kunci API: hermes model, pilih provider, tempel kunci. Kunci tersimpan di ~/.hermes/.env dengan permission ketat.

Halaman paket Nous Portal dengan Free, Plus $20, Super $100, dan Ultra $200 per bulan
Paket Nous Portal pada 19 September 2026 untuk jalur A. (1) Free hanya model gratis. (2) Plus $20 dengan kredit $22. (3) Super $100. (4) Ultra $200. Untuk jalur B, biaya mengikuti penyedia API yang Anda pilih.

Verifikasi: hermes doctor bagian Auth Providers menampilkan provider Anda sebagai logged in, dan hermes menjawab 1 pertanyaan uji. Sumber: dokumentasi Nous Portal dan Quickstart, bagian Choose a Provider.

Langkah 7: Kunci approvals dan deny list

Untuk VPS tim, ganti mode approvals ke manual dan tambahkan deny list. Nilai ini bisa diatur lewat hermes config set atau langsung di config.yaml. Perubahan deny berlaku seketika tanpa restart.

# ~/.hermes/config.yaml
approvals:
  mode: manual                  # smart untuk pribadi, manual untuk server tim
  timeout: 300                  # prompt tanpa jawaban ditolak
  deny:
    - "git push --force*"
    - "*curl*|*sh*"
    - "dd if=* of=/dev/*"
security:
  redact_secrets: true
Terminal menampilkan hermes config get approvals.mode bernilai smart dan terminal.backend bernilai local
Nilai bawaan pada uji kami sebelum Langkah 7. (1) approvals.mode = smart. (2) terminal.backend = local. Setelah Anda mengubah config.yaml, perintah yang sama harus mengembalikan manual.

Verifikasi: hermes config get approvals.mode mengembalikan manual. Bila Anda butuh isolasi nyata, set terminal.backend: docker dengan docker_forward_env: [] supaya rahasia host tidak masuk container. Sumber: bagian Tightening for a Shared or Work Machine.

Langkah 8: Pasang gateway sebagai layanan systemd

Jalankan wizard platform, pasang layanan user, aktifkan linger 1 kali, lalu periksa status dan log.

hermes gateway setup                 # pilih platform, isi token
hermes gateway install               # layanan user systemd
sudo loginctl enable-linger $USER    # hidup setelah logout dan reboot
hermes gateway status
journalctl --user -u hermes-gateway -f
Terminal menampilkan hermes gateway --help dengan subperintah run, start, stop, restart, status, install, uninstall, setup, dan enroll
Subperintah gateway pada uji kami. (1) install memasang layanan systemd atau launchd. (2) setup membuka wizard platform. Di dalam container, install menolak dan meminta hermes gateway run; di VPS biasa, install berjalan normal.

Verifikasi: hermes gateway status menampilkan running, dan systemctl --user is-enabled hermes-gateway mengembalikan enabled. Setelah reboot VPS, status tetap running berkat linger. Jangan tambahkan drop-in ExecStopPost=/bin/kill -9; dokumentasi menyebut itu memicu restart loop. Sumber: bagian Linux (systemd).

Langkah 9: Uji pertama dan baca log

Untuk melihat gateway bekerja sebelum layanan, jalankan hermes gateway run di latar depan. Kotak Gateway Starting menyebut messaging dan cron berjalan bersama. Kirim 1 pesan dari akun di allowlist dan 1 pesan dari akun asing.

Terminal menampilkan kotak Hermes Gateway Starting dan peringatan No messaging platforms enabled
hermes gateway run pada uji kami sebelum platform diaktifkan. (1) Kotak Gateway Starting. (2) Peringatan No messaging platforms enabled, yang hilang setelah Langkah 8 mengisi token platform di .env.

Verifikasi: akun allowlist mendapat jawaban, akun asing mendapat kode pairing atau diam. Log layanan dibaca dengan journalctl --user -u hermes-gateway -f. Panduan WhatsApp lengkap ada pada artikel Hermes Agent untuk WhatsApp.

Langkah 10 (opsional): Update bulanan dan pemeriksaan ulang

Hermes merilis versi baru tiap minggu pada September 2026. Jadwalkan update bulanan: perbarui, periksa konfigurasi, migrasi kunci baru, jalankan doctor, lalu restart gateway.

hermes update
hermes config check
hermes config migrate
hermes doctor
hermes gateway restart
Terminal menampilkan hermes gateway status dengan pesan Gateway is not running dan 3 perintah untuk memulai
hermes gateway status pada uji kami sebelum layanan dipasang. (1) Status not running. (2) 3 cara memulai. Setelah update, perintah ini harus kembali menampilkan running; bila tidak, jalankan hermes gateway restart.

Verifikasi: hermes --version menampilkan versi baru dan hermes gateway status kembali running. Bila update merusak sesuatu, dokumentasi Updating menyebut cara kembali: cd ~/.hermes/hermes-agent, git checkout <commit-atau-tag>, uv pip install -e ".[all]", lalu hermes gateway restart. hermes update sendiri menyimpan snapshot state sebelum update dan otomatis git reset --hard ke commit sebelumnya bila 9 berkas inti gagal diparsing. Sumber: dokumentasi Updating and Uninstalling.

Simulasi 1 hari pertama di agensi fiktif

Tabel ini simulasi dengan data dummy. Agensi Rumah Kreatif memasang Hermes di VPS 2 vCPU dengan Nous Portal Plus dan gateway Telegram untuk 3 orang.

WaktuKejadianYang dicatat sistemHasil
09.00Langkah 1 sampai 3 dijalankanClone 1,2 GB, 259 paket, 58 skillhermes --version Up to date
09.35hermes doctor2 peringatan kuning, 0 merahLanjut ke provider
09.50hermes setup --portal lewat ssh -LRefresh token di ~/.hermes/auth.json1 jawaban uji di CLI
10.10approvals.mode diganti manual, deny 3 polaconfig.yaml berubahhermes config get mengembalikan manual
10.30hermes gateway install plus lingerUnit hermes-gateway enabledStatus running
10.45Orang asing mengirim pesan ke botDitolak, kode pairing dikirimPemilik server menolak pairing
17.00VPS di-reboot untuk update kernelLayanan hidup kembali lewat lingerStatus running tanpa login

Angka pada tabel ini ilustrasi, bukan hasil pelanggan. Waktu nyata bergantung pada kecepatan jaringan ke GitHub.

Checklist serah terima VPS

  1. Hermes berjalan sebagai user non-root dengan sudo terbatas. Pemilik: pemilik server. Bukti: whoami dan ls -ld ~/.hermes.
  2. hermes doctor tanpa baris merah setelah provider tersambung. Pemilik: pemilik server. Bukti: tangkapan layar.
  3. Kunci API hanya ada di ~/.hermes/.env dengan permission 600. Pemilik: pemilik server. Bukti: stat -c %a ~/.hermes/.env.
  4. approvals.mode manual atau smart sesuai keputusan tertulis, deny list terisi. Pemilik: pemilik proses. Bukti: hermes config get.
  5. Allowlist per platform tanpa *. Pemilik: pemilik server. Bukti: baris *_ALLOWED_USERS di .env.
  6. Gateway enabled, running, dan hidup setelah reboot. Pemilik: pemilik server. Bukti: hermes gateway status setelah sudo reboot.
  7. Uji 2 akun lulus: allowlist dijawab, asing ditolak. Pemilik: pemilik proses. Bukti: 2 tangkapan layar chat.
  8. Jadwal update bulanan dan nama penanggung jawab ada di kalender. Pemilik: pemilik bisnis. Bukti: 1 baris kalender.
  9. Kriteria berhenti: bila tidak ada orang yang mau menjawab prompt approvals dalam 300 detik pada jam kerja, jangan buka gateway ke tim.

install.sh, Docker, atau Nix untuk VPS Anda

Tabel ini memakai halaman Platform Support dan Installation pada 19 September 2026.

Hal yang bisa diverifikasiinstall.sh di VPSImage DockerNix
Tier dukunganTier 1Tier 1Tier 2
Cara updatehermes update dengan rollbackTarik image baruPerbarui flake
Layanan gatewaysystemd user atau systemRestart policy containerModul NixOS
Akses root harianTidak perluTergantung hostTergantung host
Kebutuhan tambahangit, curl, xz-utilsDocker terpasangNix terpasang

Rekomendasi Rama Digital: pakai install.sh per-user untuk VPS 1 tim, karena update dan rollback paling sederhana. Pakai image Docker bila VPS Anda sudah memakai orkestrasi container dan Anda menerima bahwa hermes update tidak berlaku di dalamnya.

Pertanyaan yang sering diajukan

Apakah harus root untuk install Hermes Agent di Ubuntu? Tidak. Installer mendukung user tanpa sudo; hanya langkah Playwright --with-deps yang butuh apt. Jalankan sudo npx playwright install-deps chromium 1 kali sebagai admin, lalu install sebagai user biasa, atau lewati browser dengan --skip-browser.

Berapa lama instalasinya? Dokumentasi menyebut di bawah 2 menit pada jaringan normal. Pada uji kami, clone repositori dari GitHub berjalan 50 KB per detik pada 1 jaringan, jadi durasi bergantung pada koneksi VPS ke GitHub. Tahap uv memakai 1 sampai 5 menit menurut installer.

Kenapa hermes gateway install menolak di container? Karena unit user systemd di home yang di-mount dari host bisa dijalankan 2 kali dan menabrak token bot yang sama. Di container, jalankan hermes gateway run dengan restart policy container, atau pasang layanan sistem di container yang memakai systemd sebagai PID 1.

Apakah VPS 1 GB RAM memadai? Dokumentasi Team Telegram Assistant menyebut VPS $5 per bulan memadai karena panggilan model terjadi di luar server. Pada uji kami, folder ~/.hermes memakai 2,3 GB disk. Siapkan disk 10 GB untuk sesi dan log.

Bagaimana cara mengembalikan versi bila update rusak? Masuk ke ~/.hermes/hermes-agent, jalankan git checkout ke commit atau tag sebelumnya, lalu uv pip install -e ".[all]" dan hermes gateway restart. hermes update juga menyimpan snapshot state sebelum update dan membatalkan pull secara otomatis bila berkas inti gagal diparsing.

Apakah data percakapan keluar dari VPS? Menurut FAQ resmi, hanya panggilan ke penyedia model yang keluar, dan Hermes tidak mengirim telemetri. Sesi, memory, dan skills tersimpan di ~/.hermes/ pada VPS Anda.

Langkah berikutnya

Setelah 10 langkah ini, VPS Anda punya Hermes Agent yang hidup setelah reboot, menolak orang asing, dan meminta persetujuan untuk perintah berisiko. Batas yang tetap berlaku: keamanan mengikuti orang yang memegang approvals, dan biaya mengikuti model yang dipilih. Bila Anda ingin kami mengerjakan 10 langkah ini di VPS Anda beserta provider, gateway, memory, skills, dan SOP serah terima, layanan Jasa Install Hermes Agent menyelesaikannya dalam 2 sampai 5 hari kerja. Bila Anda ingin memastikan ruang lingkup dan akses server lebih dulu, jadwalkan Sesi Scoping Teknis 60 menit.

Sumber