Hermes Agent Docker 실행 시 Gateway + Dashboard 사용법

작성자:

Hermes Agent Docker 실행 시 Gateway + Dashboard 사용법 정리 (2026년 기준 최신)

1. 추천 Docker 실행 명령어 (Gateway + Dashboard 동시 실행)

Bash

 
docker run -d \
  --name hermes \
  --restart unless-stopped \
  -v ~/.hermes:/opt/data \
  -p 8642:8642 \    # Gateway API (OpenAI-compatible + 내부 API)
  -p 9119:9119 \    # Web Dashboard
  -e HERMES_DASHBOARD=1 \
  nousresearch/hermes-agent gateway run
 
 

중요: Dashboard는 같은 컨테이너에서 Gateway와 함께 실행해야 정상 작동합니다. (별도 컨테이너 권장하지 않음)

2. 각 포트 역할

포트 이름 용도 접근 URL 비고
8642 Gateway API OpenAI 호환 API, 내부 API, Bot 연동 http://localhost:8642 필수
9119 Web Dashboard 브라우저 관리 UI (설정, 세션, 로그 등) http://localhost:9119 옵션
 
 

3. Gateway (8642) 사용법

  • 주요 기능:
    • Telegram, Discord, Slack 등 메시징 플랫폼 연결 (항상 실행 필요)
    • OpenAI-compatible API 제공 (/v1 엔드포인트) → Open WebUI, SillyTavern, Cursor 등 연동 가능
    • Agent 실행 및 Tool Gateway 관리
  • 상태 확인:
    Bash

     
    curl http://localhost:8642/health
# 또는
docker logs -f hermes
     
     
  • 설정:
    • 처음 실행 시 hermes gateway setup (컨테이너 내부에서 실행)
    • API 키 보호: API_SERVER_KEY 환경변수 설정 강력 추천

4. Dashboard (9119) 사용법

브라우저에서 접속: http://localhost:9119

Dashboard에서 할 수 있는 주요 기능:

  • 설정 관리 (모델, Provider, Config YAML 편집)
  • API 키 안전하게 관리
  • 활성 세션 (Sessions) 모니터링 및 관리
  • Skills (자동 생성된 스킬) 확인/편집
  • Cron Jobs / Scheduled Automations 관리
  • Logs (Agent, Gateway, Error) 실시간 보기 + 필터
  • Analytics 및 사용량 통계
  • Gateway 상태 확인 (플랫폼 연결 상태)

Dashboard 옵션 (환경변수 또는 command로 제어):

  • –host 0.0.0.0 + –insecure: 외부에서 접근할 때 (보안 주의!)
  • Reverse Proxy (Nginx/Caddy) + HTTPS 추천

5. Docker Compose 추천 예시

YAML

 
services:
  hermes:
    image: nousresearch/hermes-agent:latest
    container_name: hermes
    restart: unless-stopped
    command: gateway run
    ports:
      - "8642:8642"   # Gateway
      - "9119:9119"   # Dashboard
    volumes:
      - ~/.hermes:/opt/data
    environment:
      - HERMES_DASHBOARD=1
      # - API_SERVER_KEY=your_strong_key_here   # 보안 필수
    # resources:
    #   limits:
    #     memory: 4G
 
 

6. 유용한 명령어 (컨테이너 내부)

Bash

 
# 컨테이너 들어가기
docker exec -it hermes bash

# 내부에서 실행
hermes gateway status
hermes gateway setup          # 플랫폼 재설정
hermes doctor                 # 문제 진단
hermes logs                   # 로그 확인
 
 

업데이트 방법:

Bash

 
docker pull nousresearch/hermes-agent:latest
docker stop hermes && docker rm hermes
# 위 docker run 또는 compose up -d 다시 실행