{"id":17754,"date":"2026-08-26T08:10:16","date_gmt":"2026-08-26T07:10:16","guid":{"rendered":"https:\/\/www.milesweb.co.uk\/hosting-faqs\/?p=17754"},"modified":"2026-08-26T08:10:17","modified_gmt":"2026-08-26T07:10:17","slug":"how-to-set-up-hermes-agent-managed-or-self-hosted","status":"publish","type":"post","link":"https:\/\/www.milesweb.co.uk\/hosting-faqs\/how-to-set-up-hermes-agent-managed-or-self-hosted\/","title":{"rendered":"How to set up Hermes Agent (managed or self-hosted)?"},"content":{"rendered":"\n

Hermes Agent is an always-on AI agent. It learns from your interactions and turns your workflows into reusable skills. You can run it two ways: as a managed service or self-hosted on your VPS with Docker. The managed route saves you setup time. The self-hosted route gives you full control over the models, memory, and tools. This guide walks you through both paths, step by step.
<\/p>\n\n\n\n

How Do You Set Up a Self-Hosted Hermes Agent?<\/h2>\n\n\n\n

Self-hosting puts the server, models, and security in your hands. Basic Linux and Docker knowledge helps here. Start with step one below. <\/p>\n\n\n\n

Step 1: Prepare Your VPS<\/h3>\n\n\n\n

Pick a VPS<\/strong><\/a> with a Linux distribution. Ubuntu works well for your server. You’ll need root access, plus a connection that stays stable. For hardware, 2 CPU cores and 8 GB of RAM gets the job done. This handles Docker isolation and the gateway process without strain. The Hermes container itself only needs about 1 GB of RAM, or 2\u20134 GB if you turn on browser automation.<\/p>\n\n\n\n

Once you connect over SSH, update your system first:<\/p>\n\n\n\n

sudo apt update && sudo apt upgrade -y<\/code><\/pre>\n\n\n\n
This step clears out conflicts before you install Docker. Take a few extra minutes here and create a dedicated user, set proper permissions, and enable key-based login. These small steps protect your server later.
<\/p>\n\n\n\n
Step 2: Deploy Hermes Agent With Docker<\/h3>\n\n\n\n
Docker bundles Hermes Agent with everything it needs. No need to install Python or Node.js or set environment variables manually.<\/p>\n\n\n\n
If you don’t have a VPS yet, use a ready-made Hermes Agent template. Pick a plan, complete checkout, and the system installs everything for you. During setup, you’ll create a username and password for the web terminal. Once the install finishes, open the Docker Manager, find the Hermes project, and click Open<\/em>.<\/p>\n\n\n\n
If you already run a VPS, deploy Hermes from your hosting panel instead. Go to your VPS settings, change the operating system, and search for Hermes Agent. Please select it, and the panel will install it for you.<\/p>\n\n\n\n
If you’re on a different provider, install Docker manually first. Then create a data folder for Hermes:<\/p>\n\n\n\n
mkdir -p ~\/.hermes\ncd ~\/.hermes\n<\/code><\/pre>\n\n\n\n
Run the container:
<\/p>\n\n\n\n
docker run -it --rm -v ~\/.hermes:\/opt\/data nousresearch\/hermes-agent setup\n<\/code><\/pre>\n\n\n\n
The -v flag connects your local folder to the container’s data path \u2014 this is where Hermes keeps your keys, sessions, skills, and memory. Skip it, and you lose all of that on restart.
<\/p>\n\n\n\n
Related Read: What is Hermes Agent?<\/a><\/strong><\/p>\n\n\n\n
Step 3: Run the Setup Wizard<\/h3>\n\n\n\n
Once the container starts, the setup wizard opens on its own. It gives you two options:<\/p>\n\n\n\n
    \n
  • Quick setup.<\/strong> Covers the provider, model, and messaging. Most users should pick the full setup.<\/li>\n\n\n\n
  • Full setup.<\/strong> Adds backend selection, behaviour settings, and persona configuration.<\/li>\n<\/ul>\n\n\n\n
    Choose Quick setup. You can adjust the rest later. The wizard asks you to: <\/p>\n\n\n\n
      \n
    1. Pick an LLM provider \u2014 Anthropic, OpenAI, OpenRouter, Nous Portal, or Ollama.<\/li>\n\n\n\n
    2. Enter your API key for that provider.<\/li>\n\n\n\n
    3. Choose a model from the list.<\/li>\n\n\n\n
    4. Connect a messaging platform, like Telegram, Discord, Slack, or WhatsApp. You can skip this step and test through the command line first.<\/li>\n<\/ol>\n\n\n\n
      Hermes keeps sensitive data, like your API key, in ~\/.hermes\/.env.<\/em> Everything else goes into ~\/.hermes\/config.yaml.<\/em>
      <\/p>\n\n\n\n
      Step 4: Verify the Setup<\/h3>\n\n\n\n
      Open a chat session. Confirm that Hermes can access your model without any errors.<\/p>\n\n\n\n
      hermes<\/em>

      You should see a welcome banner with your model, tools, and skills listed. Try a prompt that uses a tool \u2014 ask what’s in the current directory, for instance. If Hermes replies and runs the command, you’re set up correctly. 
      <\/p>\n\n\n\n
      Type \/exit to leave the session. Use hermes <\/em>again to start fresh, or hermes –continue<\/em> to pick up your last session.<\/p>\n\n\n\n
      If you run into empty replies or connection errors, the first thing that you should check is the API key. Run hermes setup<\/em> to fix it. Or run <\/strong>hermes doctor<\/em> to scan your entire setup for problems.<\/p>\n\n\n\n
      Step 5: Add More Models and Tools<\/h3>\n\n\n\n
      With the chat confirmed, you’re free to add more providers or hook up additional services.<\/p>\n\n\n\n
      Run hermes model<\/em> to add a new provider. It walks you through the same steps as before. Switch between providers mid-session with the \/model<\/em> command.<\/p>\n\n\n\n
      To connect a messaging channel, run hermes gateway setup<\/em> and follow the prompts. Once it’s set up, run hermes gateway run<\/em> to start the bot. Without this command, the channel stays configured but stays quiet.<\/p>\n\n\n\n
      Hermes also comes with built-in tools: terminal access, web search, file system access, and image generation. Run hermes tools<\/em> to see the list and switch each one on or off. Note that some tools, like web search, need their own API keys to work.<\/p>\n\n\n\n
      Step 6: Secure Your Setup<\/h3>\n\n\n\n
      Tirith is the scanner built into Hermes. It checks every terminal command before running it and flags risks like prompt injection or credential theft. It’s on by default. When it flags something, approve or deny it with \/approve or \/deny.<\/p>\n\n\n\n
      Control how approvals work by editing ~\/.hermes\/config.yaml:
      <\/p>\n\n\n\n
      approvals:\n   mode: manual    # manual | smart | off\n   timeout: 60\n<\/code><\/pre>\n\n\n\n
      Manual mode asks before every risky command. Lock down your messaging gateway as well. Off disables checks entirely.<\/p>\n\n\n\n
      Add your user ID to the allowed list in the same configuration file as the messaging gateway.<\/p>\n\n\n\n
      gateway:\n   telegram:\n      allowed_user_ids:\n         - 123456789\n<\/code><\/pre>\n\n\n\n
      Add your own ID here. Please follow the same procedure for any other platform you have set up.<\/p>\n\n\n\n
      Close ports 8642 <\/em>and 9119 <\/em>if you only use Hermes through a chat app:<\/p>\n\n\n\n
      sudo ufw deny 8642\nsudo ufw deny 9119\n<\/code><\/pre>\n\n\n\n
      To update Hermes, pull the latest image and swap the container:<\/p>\n\n\n\n
      docker pull nousresearch\/hermes-agent:latest\ndocker rm -f hermes\ndocker run -d --name hermes --restart unless-stopped -v \n~\/.hermes:\/opt\/data nousresearch\/hermes-agent gateway run\n<\/code><\/pre>\n\n\n\n
      Your data stays safe in the mounted folder during updates. Also turn off root SSH login, set up fail2ban, and run a malware scanner on your VPS for extra protection.
      <\/p>\n\n\n\n
      How Do You Set Up a Managed Hermes Agent?<\/h2>\n\n\n\n
      A managed Hermes Agent skips the server work. The host prepares the environment, handles updates, and manages backend security. You just pick a model and connect your channels.
      <\/p>\n\n\n\n
      Step 1: Choose a Managed Hermes Plan<\/h3>\n\n\n\n
      Log in to your hosting panel and select Hermes from the sidebar. Pick a subscription period. You can also add optional features, like ready-to-use AI credits for models such as Claude, Gemini, or GPT, or web search credits for pulling live data. Skip these if you’d rather connect your own provider key.<\/p>\n\n\n\n
      Step 2: Pick Your AI Provider<\/h3>\n\n\n\n
      When you set up, you’ll choose how Hermes connects to an AI model. Use the built-in AI credits, or enter your provider’s API key. If you bring your key, you’ll pick the exact model once the app finishes deploying.<\/p>\n\n\n\n
      Step 3: Open Your Hermes Application<\/h3>\n\n\n\n
      Once deployment’s done, open the app and grab the access key on screen. This is your gateway token \u2014 please copy it to a secure location and refrain from sharing it with others. <\/p>\n\n\n\n
      Step 4: Finish the Initial Setup<\/h3>\n\n\n\n
      Please review your settings in the setup window before proceeding. If you did not select the built-in AI option earlier, please enter your API key now and choose a model. The app sets your password automatically, so you can skip that part. Please confirm your selections to complete the process.<\/p>\n\n\n\n
      Step 5: Connect a Channel and Test It<\/h3>\n\n\n\n
      Start with a channel; Telegram, WhatsApp, and email all work. Follow the prompts on the screen to authorise it. Once that’s done, send a test message and see if Hermes replies through the model you picked.<\/p>\n\n\n\n
      Once it’s running, head to the management panel. From there you can switch providers, monitor credit usage, restart the app, view logs, or grab your access key again. <\/p>\n\n\n\n
      A Few Important Considerations<\/h2>\n\n\n\n
        \n
      • Test the CLI before adding channels<\/strong>
        Confirm Hermes responds and runs tools before you connect Telegram, Slack, or cron jobs. This makes troubleshooting far easier if something breaks later.<\/li>\n\n\n\n
      • Always mount the data volume<\/strong>
        Skip the -v<\/em> flag when running the container, and you lose your memory, skills, and settings on every restart.<\/li>\n\n\n\n
      • Keep your API keys current.<\/strong>
        Expired or wrong keys are the most common reason Hermes stops responding. Run hermes setup<\/em> to refresh them.<\/li>\n\n\n\n
      • Set the gateway allowlist
        <\/strong>Without allowed_user_ids<\/em> in your config, anyone who finds your bot can send it commands.<\/li>\n\n\n\n
      • Sandbox the terminal on a VPS
        <\/strong>By default, Hermes runs commands directly on your server. Switch to hermes config set terminal.backend docker<\/em> so commands stay isolated from the rest of your system.<\/li>\n\n\n\n
      • Back up your Hermes folder regularly
        <\/strong>The ~\/.hermes<\/em> directory holds your models, memory, skills, and sessions. Managed plans back up automatically once a day; self-hosted setups need a manual routine.<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"
        Hermes Agent is an always-on AI agent. It learns from your interactions and turns your workflows into reusable skills. You can run it two ways: as a managed service or self-hosted on your VPS with Docker. The managed route saves you setup time. The self-hosted route gives you full control over the models, memory, and […]<\/p>\n","protected":false},"author":12,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[22],"tags":[],"class_list":["post-17754","post","type-post","status-publish","format-standard","placeholder-for-hentry","category-vps-faq"],"yoast_head":"\nHow to set up Hermes Agent (managed or self-hosted)?<\/title>\n<meta name=\"description\" content=\"Learn how to set up Hermes Agent with managed or self-hosted options, including installation steps, configuration, requirements, and more.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.milesweb.co.uk\/hosting-faqs\/how-to-set-up-hermes-agent-managed-or-self-hosted\/\" \/>\n<meta property=\"og:locale\" content=\"en_GB\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"How to set up Hermes Agent (managed or self-hosted)?\" \/>\n<meta property=\"og:description\" content=\"Learn how to set up Hermes Agent with managed or self-hosted options, including installation steps, configuration, requirements, and more.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.milesweb.co.uk\/hosting-faqs\/how-to-set-up-hermes-agent-managed-or-self-hosted\/\" \/>\n<meta property=\"og:site_name\" content=\"Web Hosting FAQs by MilesWeb\" \/>\n<meta property=\"article:published_time\" content=\"2026-08-26T07:10:16+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2026-08-26T07:10:17+00:00\" \/>\n<meta name=\"author\" content=\"Pravin Dahadade\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Pravin Dahadade\" \/>\n\t<meta name=\"twitter:label2\" content=\"Estimated reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"7 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.milesweb.co.uk\/hosting-faqs\/how-to-set-up-hermes-agent-managed-or-self-hosted\/\",\"url\":\"https:\/\/www.milesweb.co.uk\/hosting-faqs\/how-to-set-up-hermes-agent-managed-or-self-hosted\/\",\"name\":\"How to set up Hermes Agent (managed or self-hosted)?\",\"isPartOf\":{\"@id\":\"https:\/\/www.milesweb.co.uk\/hosting-faqs\/#website\"},\"datePublished\":\"2026-08-26T07:10:16+00:00\",\"dateModified\":\"2026-08-26T07:10:17+00:00\",\"author\":{\"@id\":\"https:\/\/www.milesweb.co.uk\/hosting-faqs\/#\/schema\/person\/8ec3f61c42d57dcdfe230b85246842ad\"},\"description\":\"Learn how to set up Hermes Agent with managed or self-hosted options, including installation steps, configuration, requirements, and more.\",\"breadcrumb\":{\"@id\":\"https:\/\/www.milesweb.co.uk\/hosting-faqs\/how-to-set-up-hermes-agent-managed-or-self-hosted\/#breadcrumb\"},\"inLanguage\":\"en-GB\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.milesweb.co.uk\/hosting-faqs\/how-to-set-up-hermes-agent-managed-or-self-hosted\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.milesweb.co.uk\/hosting-faqs\/how-to-set-up-hermes-agent-managed-or-self-hosted\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/www.milesweb.co.uk\/hosting-faqs\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"How to set up Hermes Agent (managed or self-hosted)?\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.milesweb.co.uk\/hosting-faqs\/#website\",\"url\":\"https:\/\/www.milesweb.co.uk\/hosting-faqs\/\",\"name\":\"Web Hosting FAQs by MilesWeb\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/www.milesweb.co.uk\/hosting-faqs\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-GB\"},{\"@type\":\"Person\",\"@id\":\"https:\/\/www.milesweb.co.uk\/hosting-faqs\/#\/schema\/person\/8ec3f61c42d57dcdfe230b85246842ad\",\"name\":\"Pravin Dahadade\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-GB\",\"@id\":\"https:\/\/www.milesweb.co.uk\/hosting-faqs\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/3dbf83949fba3453ab1d66d34757a110?s=96&d=blank&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/3dbf83949fba3453ab1d66d34757a110?s=96&d=blank&r=g\",\"caption\":\"Pravin Dahadade\"},\"description\":\"With an interest in doing something creative daily. I like to write technical blogs related to web hosting, digital marketing, and other IT topics. Also like to spend leisure time on social media to find different strategies for client engagement.\",\"url\":\"https:\/\/www.milesweb.co.uk\/hosting-faqs\/author\/pravin-d\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"How to set up Hermes Agent (managed or self-hosted)?","description":"Learn how to set up Hermes Agent with managed or self-hosted options, including installation steps, configuration, requirements, and more.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.milesweb.co.uk\/hosting-faqs\/how-to-set-up-hermes-agent-managed-or-self-hosted\/","og_locale":"en_GB","og_type":"article","og_title":"How to set up Hermes Agent (managed or self-hosted)?","og_description":"Learn how to set up Hermes Agent with managed or self-hosted options, including installation steps, configuration, requirements, and more.","og_url":"https:\/\/www.milesweb.co.uk\/hosting-faqs\/how-to-set-up-hermes-agent-managed-or-self-hosted\/","og_site_name":"Web Hosting FAQs by MilesWeb","article_published_time":"2026-08-26T07:10:16+00:00","article_modified_time":"2026-08-26T07:10:17+00:00","author":"Pravin Dahadade","twitter_misc":{"Written by":"Pravin Dahadade","Estimated reading time":"7 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/www.milesweb.co.uk\/hosting-faqs\/how-to-set-up-hermes-agent-managed-or-self-hosted\/","url":"https:\/\/www.milesweb.co.uk\/hosting-faqs\/how-to-set-up-hermes-agent-managed-or-self-hosted\/","name":"How to set up Hermes Agent (managed or self-hosted)?","isPartOf":{"@id":"https:\/\/www.milesweb.co.uk\/hosting-faqs\/#website"},"datePublished":"2026-08-26T07:10:16+00:00","dateModified":"2026-08-26T07:10:17+00:00","author":{"@id":"https:\/\/www.milesweb.co.uk\/hosting-faqs\/#\/schema\/person\/8ec3f61c42d57dcdfe230b85246842ad"},"description":"Learn how to set up Hermes Agent with managed or self-hosted options, including installation steps, configuration, requirements, and more.","breadcrumb":{"@id":"https:\/\/www.milesweb.co.uk\/hosting-faqs\/how-to-set-up-hermes-agent-managed-or-self-hosted\/#breadcrumb"},"inLanguage":"en-GB","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.milesweb.co.uk\/hosting-faqs\/how-to-set-up-hermes-agent-managed-or-self-hosted\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.milesweb.co.uk\/hosting-faqs\/how-to-set-up-hermes-agent-managed-or-self-hosted\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.milesweb.co.uk\/hosting-faqs\/"},{"@type":"ListItem","position":2,"name":"How to set up Hermes Agent (managed or self-hosted)?"}]},{"@type":"WebSite","@id":"https:\/\/www.milesweb.co.uk\/hosting-faqs\/#website","url":"https:\/\/www.milesweb.co.uk\/hosting-faqs\/","name":"Web Hosting FAQs by MilesWeb","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.milesweb.co.uk\/hosting-faqs\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-GB"},{"@type":"Person","@id":"https:\/\/www.milesweb.co.uk\/hosting-faqs\/#\/schema\/person\/8ec3f61c42d57dcdfe230b85246842ad","name":"Pravin Dahadade","image":{"@type":"ImageObject","inLanguage":"en-GB","@id":"https:\/\/www.milesweb.co.uk\/hosting-faqs\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/3dbf83949fba3453ab1d66d34757a110?s=96&d=blank&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/3dbf83949fba3453ab1d66d34757a110?s=96&d=blank&r=g","caption":"Pravin Dahadade"},"description":"With an interest in doing something creative daily. I like to write technical blogs related to web hosting, digital marketing, and other IT topics. Also like to spend leisure time on social media to find different strategies for client engagement.","url":"https:\/\/www.milesweb.co.uk\/hosting-faqs\/author\/pravin-d\/"}]}},"views":0,"_links":{"self":[{"href":"https:\/\/www.milesweb.co.uk\/hosting-faqs\/wp-json\/wp\/v2\/posts\/17754","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.milesweb.co.uk\/hosting-faqs\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.milesweb.co.uk\/hosting-faqs\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.milesweb.co.uk\/hosting-faqs\/wp-json\/wp\/v2\/users\/12"}],"replies":[{"embeddable":true,"href":"https:\/\/www.milesweb.co.uk\/hosting-faqs\/wp-json\/wp\/v2\/comments?post=17754"}],"version-history":[{"count":4,"href":"https:\/\/www.milesweb.co.uk\/hosting-faqs\/wp-json\/wp\/v2\/posts\/17754\/revisions"}],"predecessor-version":[{"id":17758,"href":"https:\/\/www.milesweb.co.uk\/hosting-faqs\/wp-json\/wp\/v2\/posts\/17754\/revisions\/17758"}],"wp:attachment":[{"href":"https:\/\/www.milesweb.co.uk\/hosting-faqs\/wp-json\/wp\/v2\/media?parent=17754"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.milesweb.co.uk\/hosting-faqs\/wp-json\/wp\/v2\/categories?post=17754"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.milesweb.co.uk\/hosting-faqs\/wp-json\/wp\/v2\/tags?post=17754"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}