diff --git a/docs/marketplace-docs/guides/hermes/index.md b/docs/marketplace-docs/guides/hermes/index.md new file mode 100644 index 00000000000..1c4d0b66fe1 --- /dev/null +++ b/docs/marketplace-docs/guides/hermes/index.md @@ -0,0 +1,114 @@ +--- +title: "Deploy Hermes Agent" +description: "This tutorial will show you how to deploy Hermes Agent as a Quick Deploy App." +published: 2026-06-17 +modified: 2026-06-17 +keywords: ['AI', 'AI Agent'] +tags: ["quick deploy apps", "AI", "AI Agent"] +aliases: ['/products/tools/marketplace/guides/hermes/','/guides/hermes/'] +external_resources: +- '[Hermes Agent](https://hermes-agent.nousresearch.com)' +- '[Hermes Agent Documentation](https://hermes-agent.nousresearch.com/docs)' +authors: ["Akamai"] +contributors: ["Akamai"] +license: '[CC BY-ND 4.0](https://creativecommons.org/licenses/by-nd/4.0)' +marketplace_app_id: 2141074 +marketplace_app_name: "Hermes" +--- + +[Hermes Agent](https://hermes-agent.nousresearch.com) is an open-source AI agent platform designed for autonomous task execution through a persistent Relay service. The Relay connects communication channels, tools, and AI models, allowing the agent to receive instructions, perform actions, and automate multi-step workflows. Administrators configure and manage the system through a CLI setup wizard and a local web dashboard. Our Quick Deploy App allows you to connect to the Hermes Agent dashboard via a secure HTTPS endpoint protected by HTPASSWD. + +This Quick Deploy App creates a Hermes Agent user on the system called `hermes`. + +## Deploying a Quick Deploy App + +{{% content "deploy-marketplace-apps-shortguide" %}} + +{{% content "marketplace-verify-standard-shortguide" %}} + +{{< note >}} +**Estimated deployment time:** Hermes Agent should be fully installed within 5-10 minutes after the Compute Instance has finished provisioning. +{{< /note >}} + +## Configuration Options + +- **Supported distributions:** Ubuntu 24.04 LTS +- **Recommended plan:** All plan types and sizes can be used. + +## Hermes Agent Options + +- **Email address** *(optional)*: Enter the email address you want to use for SOA email DNS record. + +{{% content "marketplace-required-limited-user-fields-shortguide" %}} + +{{% content "marketplace-custom-domain-fields-shortguide" %}} + +{{% content "marketplace-special-character-limitations-shortguide" %}} + +## Getting Started after Deployment + +### Performing Hermes Agent Onboarding + +Once the deployment is complete, `hermes` will be installed on the instance but will not be running. Before you can start using Hermes Agent, you need to go through the setup wizard. This Quick Deploy App triggers the onboarding for you when you log in as root. + +1. Log into the instance. + + If you disabled root login to the server during the setup of the Hermes Agent app, you need to log into the server as the sudo user. + +```command + ssh admin@YOUR_INSTANCE_IP +``` + + Replace `YOUR_INSTANCE_IP` with the IP address of your Linode instance and `admin` with the sudo user you created. + +1. Escalate privileges to root. + + Once you've logged in, note the [motd](https://man7.org/linux/man-pages/man5/motd.5.html): + +```output + ********************************************************* + Akamai Connected Cloud Hermes Quick Deploy App + Credentials File: /home/admin/.credentials + Documentation: https://www.linode.com/docs/marketplace-docs/guides/hermes/ + ********************************************************* +``` + + Copy the sudo password from `~/.credentials.txt` and enter the following command from the terminal: + +```command + sudo su - +``` + + When prompted for the password, paste the sudo password you got from the `~/.credentials.txt` file. When you log in as **root**, note the following message about the setup wizard. If you are ready to perform the onboarding, enter `y` and it will take you to Hermes Agent's & Hermes Gateway setup wizards where you can complete the configuration. + + Once onboarding is complete, the setup script is removed. + +### Confirm Hermes Status + +At this time, you've configured Hermes Agent on the server. To verify the relay is running, you need to become the `hermes` user. Enter the following from the terminal as the **root** user: + +```command +su - hermes +``` + +To view the hermes status, enter the following as the **hermes** user: + +```command +hermes agent status +``` + +### Confirm Gateway Status + +To verify the gateway is running, you need to become the `hermes` user. Enter the following from the terminal as the **root** user: + +```command +su - hermes +``` + +To view the gateway status, enter the following as the **hermes** user: + +```command +hermes gateway status +``` + +{{% content "marketplace-update-note-shortguide" %}} \ No newline at end of file