Install Hermes Agent dengan Docker: Setup 5 Menit untuk Pemula

Install Hermes AI Agent dengan Docker dalam 5 menit: setup cepat, mudah, dan siap produksi untuk pemula maupun developer di 2026.

← Kembali ke Blog

Kenapa Pakai Docker?

Docker menyederhanakan proses instalasi Hermes Agent dengan cara:

Langkah 1: Install Docker

Jika belum punya Docker, install dulu:

# Ubuntu/Debian
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
sudo usermod -aG docker $USER

# Verifikasi
sudo docker --version

Logout dan login ulang agar group docker aktif, atau jalankan newgrp docker.

Langkah 2: Pull Image Hermes Agent

docker pull nousresearch/hermes-agent:latest

Image ini berisi Hermes Agent versi terbaru lengkap dengan semua dependencies.

Langkah 3: Buat Folder untuk Data Persisten

mkdir -p ~/hermes-data/memory ~/hermes-data/logs

Folder ini akan menyimpan memori agent dan log, sehingga data tidak hilang saat container di-restart.

Langkah 4: Setup Environment Variables

Buat file .env untuk API key:

cat > ~/hermes-data/.env << 'EOF'
OPENAI_API_KEY=sk-your-api-key-here
HERMES_MODEL=gpt-4o-mini
HERMES_MEMORY_TYPE=chroma
TZ=Asia/Jakarta
EOF

Langkah 5: Jalankan Container

docker run -d \
  --name hermes-agent \
  --restart unless-stopped \
  -p 8000:8000 \
  -v ~/hermes-data/.env:/app/.env \
  -v ~/hermes-data/memory:/app/memory \
  -v ~/hermes-data/logs:/app/logs \
  nousresearch/hermes-agent:latest

Penjelasan flag:

Langkah 6: Verifikasi Container Berjalan

docker ps
docker logs hermes-agent

Jika container status Up dan log menunjukkan agent siap — selamat, Hermes Agent sudah berjalan di Docker!

Perintah Docker yang Berguna

PerintahFungsi
docker stop hermes-agentHentikan agent
docker start hermes-agentJalankan agent
docker restart hermes-agentRestart agent
docker logs -f hermes-agentLihat log real-time
docker exec -it hermes-agent bashAkses shell container
docker pull nousresearch/hermes-agent:latestUpdate image

Docker Compose (Lebih Rapi)

Buat file docker-compose.yml untuk konfigurasi yang lebih terstruktur:

version: '3.8'
services:
  hermes:
    image: nousresearch/hermes-agent:latest
    container_name: hermes-agent
    restart: unless-stopped
    ports:
      - "8000:8000"
    volumes:
      - ./hermes.env:/app/.env
      - ./memory:/app/memory
      - ./logs:/app/logs
    environment:
      - TZ=Asia/Jakarta

Jalankan: docker-compose up -d

Kesimpulan

Docker adalah metode paling praktis untuk menjalankan Hermes AI Agent, terutama untuk pemula atau mereka yang ingin deployment cepat tanpa ribet. Dengan Docker, kamu bisa punya agent berjalan dalam 5 menit — tinggal pull image, set API key, dan run container. Update juga semudah: pull image baru, stop container lama, dan start container baru.

Troubleshooting Docker: Error Umum dan Solusinya

GejalaPenyebab UmumSolusi
Container langsung exit setelah startAPI key kosong atau salah format di .envCek docker logs nama-container; pastikan OPENAI_API_KEY terisi tanpa spasi/kutip
port is already allocatedPort 3000 dipakai aplikasi lainJalankan dengan -p 3001:3000 lalu akses via port 3001
Data agent hilang setelah restartFolder data tidak di-mount sebagai volumePastikan flag -v mengarah ke folder host yang benar
Permission denied di folder dataUID di container berbeda dengan hostsudo chown -R 1000:1000 ./data atau sesuaikan user di docker-compose
Container OOM / tiba-tiba matiMemori VPS kecil (di bawah 1 GB)Tambah swap atau batasi memori: --memory=768m; matikan service lain
Update versi gagal / konfigurasi kacauImage lama tertimpa tanpa backup volumeBackup folder data dulu, lalu docker compose pull && docker compose up -d

Kalau semua langkah di atas sudah dicoba dan agent tetap tidak jalan, cek tiga hal terakhir: versi Docker (jalankan docker version, minimal 20.10), arsitektur VPS (image ARM vs x86), dan apakah VPS Anda memblokir outbound ke API OpenAI — beberapa provider cloud memang membatasi port keluar secara default.

FAQ

Apakah Docker Hermes Agent gratis?
Ya, imagenya gratis dan open-source, sama seperti Hermes Agent-nya.

Berapa ukuran Docker image?
Sekitar 1.5-2 GB untuk image lengkap dengan dependencies.

Apakah bisa pakai Docker di Windows?
Bisa. Install Docker Desktop untuk Windows, dan semua perintah di atas tetap sama.

Bagaimana cara update Hermes Agent di Docker?
docker pull nousresearch/hermes-agent:latest && docker restart hermes-agent

Apakah data memori aman saat container di-restart?
Aman. Data tersimpan di folder yang di-mount (-v), jadi persisten walau container dihapus.

Bisa jalankan multi-agent dengan Docker?
Bisa. Jalankan beberapa container dengan nama dan port berbeda.

Apakah Docker lebih lambat dari instalasi native?
Marginally lebih lambat (~5%), tapi tidak terasa untuk penggunaan sehari-hari.

Bisa akses Hermes Agent dari browser?
Bisa, buka http://localhost:8000 di browser setelah container berjalan.

Bagaimana cara backup data Docker Hermes?
Cukup backup folder ~/hermes-data/ — semua data ada di sana.

Apakah Docker aman untuk production?
Sangat aman. Banyak perusahaan menggunakan Docker untuk production deployment.

Apakah Hermes Agent butuh GPU?
Tidak untuk pemakaian standar. Image Docker berjalan di CPU VPS dengan RAM minimal 2 GB. GPU baru relevan kalau Anda menjalankan model lokal berukuran besar.

Bagaimana cara mengganti port default 8000?
Ubah pemetaan port saat menjalankan container, misalnya -p 8080:8000, lalu akses lewat http://localhost:8080. Jangan lupa sesuaikan juga konfigurasi reverse proxy bila ada.

Baca juga (terkait)

🚀 Mulai Belajar AI Sekarang!

Dapatkan akses ke materi belajar AI yang terstruktur dan mudah dipahami.

Lihat Paket Belajar →

Tags:

# HermesAgentDocker # InstallHermesDocker # DockerHermesAgent # HermesContainer # DeployHermesDenganDocker
Bagikan artikel ini: