Updated on 2026-06-17 GMT+08:00

Getting Started

This solution uses port 22 for remote login to cloud servers via CloudShell, with IP whitelist configured by default. If remote login is required, you can directly use CloudShell for remote access.

After successful deployment of this solution, environment initialization and application installation are expected to take approximately 10-15 minutes. Deployment time may vary due to network and bandwidth conditions. The solution will be fully functional only after deployment is complete.

(Optional) Modifying Security Group Rules

A security group is a collection of access control rules to control traffic to and from cloud resources, such as cloud servers, containers, and databases. Cloud resources associated with the same security group have the same security requirements and are mutually trusted within a VPC.

You can modify security group rules, for example, by adding, modifying, or deleting a TCP port, as follows:

  • Adding a security group rule: Add an inbound rule and enable a TCP port if needed.
  • Modifying a security group rule: Inappropriate security group settings may introduce serious security risks. You can modify security group rules to ensure the network security of your ECSs.
  • Deleting a security group rule: If the source or destination IP address of an inbound or outbound security group rule changes, or a port needs to be disabled, you can delete the security group rule.

Hermes Agent Model Configuration

  1. Logging in to the server remotely: Open the local terminal, enter `ssh root@{public IP}`, and then enter the server password to log in to the server.

    Figure 1 SSH login

  2. Model Cofiguration

    //Execute the following command in the command line.
    docker exec -it hermes bash
    //Activate the virtual environment
    source /opt/hermes/.venv/bin/activate
    //Configure the model
    hermes model
    Figure 2 Activate the virtual environment
    Figure 3 Select "Custom endpoint (enter URL manually)"
    Figure 4 Configure base URL and API key

Add a Channel (Discord)

This section takes Discord as an example. Each channel has its own configuration steps. For other channels, please refer to official documentations.

  1. Create a Discord Application

    Figure 5 Go to Discord Developer Portal (https://discord.com/developers/applications), then create a new application

  2. Create the Bot, Get the Bot Token

    Figure 6 Click Bot -> Reset Token
    Figure 7 Copy -> Save

  3. Enable Privileged Gateway Intents

    Figure 8 Toggle on Privileged Gateway Intents and save

  4. Generate the Invite URL

    Figure 9 Select Installation-> Enable Guild Install -> Under Default Install Settings for Guild Install, select the options listed below

  5. Invite to Your Server

    Figure 10 Open the invite URL in your browser -> Add to Server
    Figure 11 Select your sever and authorize

  6. Find Your Discord User ID

    Figure 12 Open Discord -> Settings -> Developer ->toggle Developer Mode to ON
    Figure 13 Copy User ID -> Save

  7. Logging in to the server: If you did not log out of the server in the previous phase, you can skip this step. Otherwise, log in to the server by referring to step 1 "Activate the virtual environment" in this document.
  8. Add a channel: Run hermes gateway setup to start the configuration.

    Figure 14 Select Discord
    Figure 15 Paste token
    Figure 16 Paste user IDs
    Figure 17 Restart the gateway
    Figure 18 Start chatting