Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
hermes_installation_on_windows_11 [29 June 2026 / 15:58:33] – kadekhermes_installation_on_windows_11 [09 July 2026 / 18:44:46] (current) – kadek
Line 25: Line 25:
  
   docker run -it --rm -v C:\Users\YourUsername\hermes-data:/opt/data nousresearch/hermes-agent:latest setup   docker run -it --rm -v C:\Users\YourUsername\hermes-data:/opt/data nousresearch/hermes-agent:latest setup
- 
  
 === #4 Create docker-compose.yml === === #4 Create docker-compose.yml ===
Line 35: Line 34:
 Paste the following: Paste the following:
  
-  services: +services: 
-    hermes: +  hermes-cli: 
-      image: nousresearch/hermes-agent:latest +    image: nousresearch/hermes-agent:latest 
-      container_name: hermes +    container_name: hermes-cli 
-   +    stdin_open: true 
-      restart: unless-stopped +    tty: true 
-   +    volumes: 
-      volumes: +      - C:\Users\YourUsername\hermes-data:/opt/data 
-        - C:\Users\KdeK\hermes-data:/opt/data +  hermes-gateway: 
-   +    image: nousresearch/hermes-agent:latest 
-      ports: +    container_name: hermes-gateway 
-        - "8642:8642" +    command: gateway run 
-        - "9119:9119" +    restart: unless-stopped 
-   +    volumes: 
-      stdin_open: true +      - C:\Users\YourUsername\hermes-data:/opt/data 
-      tty: true+  hermes-dashboard: 
 +    image: nousresearch/hermes-agent:latest 
 +    container_name: hermes-dashboard 
 +    command: dashboard --host 0.0.0.0 --port 9119 --no-open 
 +    restart: unless-stopped 
 +    ports: 
 +      - "9119:9119" 
 +    volumes: 
 +      - C:\Users\YourUsername\hermes-data:/opt/data
  
 === #5 Configure the Environment Variables === === #5 Configure the Environment Variables ===
  
-Create or edit:+Create a file named:
  
   C:\Users\YourUsername\hermes-data\.env   C:\Users\YourUsername\hermes-data\.env
  
-Example:+Example of the values:
  
   OPENROUTER_API_KEY=sk-or-v1-ABCDEFGabcdefg0123456789   OPENROUTER_API_KEY=sk-or-v1-ABCDEFGabcdefg0123456789
Line 70: Line 77:
   - TELEGRAM_ALLOWED_USERS is your Telegram numeric User ID.   - TELEGRAM_ALLOWED_USERS is your Telegram numeric User ID.
  
-=== Start Hermes ===+=== #6 Start Hermes ===
  
   cd C:\Users\YourUsername\hermes-data   cd C:\Users\YourUsername\hermes-data
Line 79: Line 86:
 === #7 Verify Hermes === === #7 Verify Hermes ===
  
-View the logs:+View the logs for Gateway & Dashboard:
  
-  docker logs -f hermes +  docker logs hermes-gateway --tail 10 
- +  docker logs hermes-dashboard --tail 10
-A successful startup should display messages similar to: +
- +
-  Starting Hermes Gateway... +
-  Connecting to telegram... +
-  Connected to Telegram +
-  Gateway running +
- +
-Press Ctrl+C to stop viewing the logs. +
-This does not stop Hermes.+
  
 === #8 Pair Telegram === === #8 Pair Telegram ===
Line 109: Line 107:
 This connects to the running Hermes instance without stopping the Telegram gateway. Type /exit to exit the CLI. This connects to the running Hermes instance without stopping the Telegram gateway. Type /exit to exit the CLI.
  
 +----
 +
 +=== Daily Startup ===
 +
 +After Windows starts:
 +
 +  - Start Docker Desktop.
 +  - Wait until Docker Desktop reports Engine running.
 +  - Open PowerShell, and run these commands:
 +
 +  cd C:\Users\YourUsername\hermes-data
 +  docker compose up -d
 +
 +A successful startup should display messages similar to:
 +
 +  PS C:\Users\YourUsername\hermes-data> docker compose up -d
 +  [+] up 4/4
 +   ✔ Network hermes-data_default Created                                                                              0.0s
 +   ✔ Container hermes-gateway    Started                                                                              0.6s
 +   ✔ Container hermes-cli        Started                                                                              0.6s
 +   ✔ Container hermes-dashboard  Started                                                                              0.8s
 +
 +Hermes, the Dashboard, and the Telegram Gateway will start automatically.
 +Access the dashboard via this URL: http://localhost:9119
 +
 +=== Daily Shutdown ===
 +
 +You may simply shut down Windows.
 +Docker will gracefully stop the Hermes container.
 +
 +Alternatively:
 +
 +  docker compose down
 +
 +=== Updating Hermes ===
 +
 +To update Hermes to the latest version:
 +
 +  docker compose pull
 +
 +=== Backup ===
 +
 +Back up the following directory periodically:
 +
 +  C:\Users\YourUsername\hermes-data
  
 +This folder contains your configuration, memories, sessions, and database.