---
title: "Hermes Hearth Update: Every New Feature, Step by Step | Komputer Mechanic"
url: https://komputermechanic.com/tutorials/hermes-hearth-update
description: "Set up the Hermes v0.23 Hearth update step by step: every Hermes in one Desktop app, bot group chats, who answers, /handoff to Telegram, /rewind and the Webapp in a browser."
lang: en
---

Home (https://komputermechanic.com/)Tutorials (https://komputermechanic.com/tutorials)Hermes Hearth update

AI Agents // Hermes

# Hermes Hearth update: every new feature step by step

This guide goes with the video "Hermes Just Got A HUGE Update". It has every step from the video, with the commands and prompts ready to copy.

28 steps · 6 parts · copy-paste ready

181 builders viewed

— Watch the Full Tutorial

## // Contents

### Part 01 / 06 — Every Hermes in one Desktop app

- 1 Check your Hermes version
- 2 Too old? Update it
- 3 A Hermes on Hostinger (Remote gateway)
- 4 A Hermes on your Tailscale network (Remote gateway)
- 5 Any VPS over SSH: check if you already have a key
- 6 Make a key
- 7 Copy the key to your server
- 8 Check: log in without a password
- 9 Add the server in Desktop (SSH)

### Part 02 / 06 — Bots and group chats

- 10 Keep Hermes running on that server (SSH servers only, once)
- 11 Check the gateway
- 12 Make the group

### Part 03 / 06 — Who answers in a group

- 13 Open the group settings and pick who answers

### Part 04 / 06 — One gateway: move a chat to Telegram

- 14 Connect Telegram to this Hermes (once)
- 15 Tell Hermes where handoffs go (once)
- 16 Hand off the chat

### Part 05 / 06 — /rewind

- 17 Open the list and pick a message

### Part 06 / 06 — The Desktop app in a browser tab (Webapp)

- 18 Turn the Webapp on
- 19 Restart the gateway
- 20 Option A (without Tailscale): open a tunnel
- 21 Option A: get your link
- 22 Option B (with Tailscale): put Tailscale on your server (once)
- 23 Option B: sign in to Tailscale
- 24 Option B: give the Webapp a private address (once)
- 25 Option B: tell Hermes that address (once)
- 26 Option B: restart the gateway
- 27 Option B: get your link (every time)
- 28 Sign out every browser tab

WHAT YOU'LL NEED

## Prerequisites

- ▸ Hermes v0.23.0 or newer on every server you connect
- ▸ Hermes Desktop on your Mac or Windows PC

Some steps run on your server. You can type the command, or paste the prompt into your Hermes chat and let your agent do it. Steps on your own computer are commands only.

All 28 steps are. Or skip the setup:

Membership

#### Build beyond this tutorial

- 3 paid tutorials of your choice today
- Every new tutorial, the day it drops
- One-line auto-installers for what you unlock
- Private members Telegram
- Priority inbox, reply within 24h

$10/month. $20 covers your first 2 months.

Become a member (https://komputermechanic.com/membership)

### Get all 28 steps by email

No card needed.

Want them as a single Markdown file? We'll email you a 6 digit code to confirm.

Part 01 / 06

## Every Hermes in one Desktop app

You add each Hermes once. Then you switch between them from one menu. Where you add them: Settings → Gateways → Saved connections → + Add connection. Local is the Hermes on this computer, Hermes Cloud is Hermes in Nous' cloud, Remote gateway is a Hermes with a web address and a login (Hostinger, or Tailscale), and SSH is any VPS you log in to with root@IP. Give every connection a clear name, like Hostinger or Contabo. That name is what you see when you switch.

STEP 1

### Check your Hermes version

Your server

```
hermes --version
```

You need `v0.23.0` or newer.

**In the Desktop app:** the version shows at the bottom left. Update the app if it's older.

STEP 2

### Too old? Update it

Your server

```
hermes update
```

Or paste into Hermes

```
Tell me which Hermes version this server runs. If it is older than 0.23.0, update
Hermes and tell me the new version.
```

**Check:** `hermes --version` shows `v0.23.0` or newer.

STEP 3

### A Hermes on Hostinger (Remote gateway)

Hostinger, then Hermes Desktop

In Hostinger, open your VPS → click **Open App**. A new tab opens with your Hermes.

Copy the address from `https://` up to the first `/` after the domain. Leave the `/` out. Example: `https://hermes-abc123.hstgr.cloud`

Then in Desktop: Settings → Gateways → Saved connections → + Add connection → **Remote gateway**, and fill in:

- **Name:** anything you like, for example Hostinger
- **Gateway URL:** the address you copied, e.g. `https://hermes-abc123.hstgr.cloud`
- **Authentication:** Sign in

Click **Sign In**. A second Sign In button appears. Click the lower one. Type the Hermes username and password from your Hostinger setup. The username is often `hermes`.

**Check:** Authentication says **Signed in**.

Click **Save connection**, then **Test**. Save stays grey until the Name field has text.

**Check:** you see "Hostinger reachable".

STEP 4

### A Hermes on your Tailscale network (Remote gateway)

Your dashboard, then Hermes Desktop

Your computer and the server must be on the same Tailscale account.

Accordo Pro or NEXORA: open your dashboard → Integrations → **Hermes Desktop**. It shows the address, the username and the password.

Add it the same way as step 3, with that address:

- **Name:** for example Accordo Pro
- **Gateway URL:** the address from the card, e.g. `https://myserver.tail1234.ts.net:8445`

**Check:** Test says "Accordo Pro reachable".

STEP 5

### Any VPS over SSH: check if you already have a key

Your own computer

Mac Windows

Desktop logs in to your server with a key, not a password. You make the key once and copy it to your server once.

These steps run on **your own computer**. Mac: open **Terminal**. Windows: open **PowerShell**.

Mac

```
ls ~/.ssh
```

Windows

```
dir $env:USERPROFILE\.ssh
```

Do you see `id_ed25519.pub`? Then you already have a key. Skip to step 7.

STEP 6

### Make a key

Your own computer

Mac Windows

```
ssh-keygen -t ed25519
```

Press Enter at every question.

Does it ask `Overwrite (y/n)?`? Type `n`. You already have a key, and overwriting it locks you out of your servers.

STEP 7

### Copy the key to your server

Your own computer

Mac Windows

Mac

```
ssh-copy-id root@YOUR-SERVER-IP
```

Windows (one line)

```
type $env:USERPROFILE\.ssh\id_ed25519.pub | ssh root@YOUR-SERVER-IP "mkdir -p ~/.ssh && chmod 700 ~/.ssh && cat >> ~/.ssh/authorized_keys && chmod 600 ~/.ssh/authorized_keys"
```

Type your server password. This is the last time you need it.

Does it ask `Are you sure you want to continue connecting?`? Type `yes`.

STEP 8

### Check: log in without a password

Your own computer

```
ssh root@YOUR-SERVER-IP
```

You are logged in, and nobody asked for a password. Type `exit` to leave.

STEP 9

### Add the server in Desktop (SSH)

Hermes Desktop

Settings → Gateways → Saved connections → + Add connection → **SSH**, and fill in:

- **Name:** for example Contabo
- **SSH host:** `root@YOUR-SERVER-IP`
- **Hermes path:** leave it on auto-detect

Click **Save connection**, then **Test**.

**Check:** you see "Contabo reachable".**Switch between your setups:** at the bottom of the Sessions list, click the device name, then pick a setup.**Check:** the sessions and bots of that setup load.

Part 02 / 06

## Bots and group chats

The Bots tab lists every agent from every setup, grouped by setup. Click one to talk to it.

STEP 10

### Keep Hermes running on that server (SSH servers only, once)

Your server

First switch to the setup whose bots you want. A group lives on one setup. Use the switcher at the bottom of the Sessions list. If you skip this, Desktop says the group will live on that other setup.

A group needs Hermes running on the server all the time, not only while Desktop is open. Hostinger and Tailscale setups already run all the time. Skip this step for those.

On the server:

```
hermes gateway install --system --run-as-user root
```

Not root

```
sudo hermes gateway install --system
```

Or paste into Hermes

```
Install the Hermes gateway on this server as a system service that starts at boot.
Don't restart or stop it yourself. Tell me the command if it needs me to run it.
```

STEP 11

### Check the gateway

Your server

```
hermes gateway list
```

**Check:** every bot shows a ✓.

STEP 12

### Make the group

Hermes Desktop

Bots tab → **+** → **New Group Chat** → pick 2 to 6 bots → **Create Group**. Rename it with the pencil icon.

Then send a message like `Hi everyone`.

**Check:** every bot in the group answers.

Part 03 / 06

## Who answers in a group

Give the group a purpose, then decide who answers a message that names nobody.

STEP 13

### Open the group settings and pick who answers

Hermes Desktop

Click the **group's name** at the top of the chat (not the arrow next to it). The **Group chat settings** panel opens.

Fill in Purpose and Shared notes (optional). Every bot in the group reads them. Example purpose: `Plan and ship my client websites`.

Under **Who answers a message that names nobody**, pick one:

- **Everyone answers**: every bot replies
- **Lead: (a bot)**: the lead answers and hands work to the other bots
- **Pick who answers automatically**: Hermes picks the best bot for each message

Click **Save**.

**Check:** with "Pick who answers automatically" on, ask a coding question. Your developer bot answers.

Tip: `@name` and `@everyone` always go straight to those bots.

Part 04 / 06

## One gateway: move a chat to Telegram

Hermes now runs one gateway per machine. Desktop, the terminal and Telegram all use that one gateway. So a chat can move from your desk to your phone and back.

STEP 14

### Connect Telegram to this Hermes (once)

Your Hermes chat

Skip this if your bot already answers you in Telegram. Otherwise paste this into your Hermes chat:

```
Connect Telegram to this Hermes. Walk me through making a bot with BotFather, then
save the bot token and my Telegram user ID. Don't restart the gateway yourself.
Tell me the command if it needs one.
```

STEP 15

### Tell Hermes where handoffs go (once)

Telegram

Open your bot in Telegram and send:

```
/sethome
```

STEP 16

### Hand off the chat

Hermes Desktop

In a Desktop chat, type:

```
/handoff telegram
```

Wait until the agent finishes its answer first.

**Check:** Desktop says the session was handed off to Telegram. Your bot sends "Continuing here in Telegram".**Keep talking on your phone.** Example: "I'm on my way to Sarah now. Give me the three most important questions only." The agent still knows everything from the Desktop chat.**Back at your desk:** open the chat under **Telegram** in the Desktop sessions list and carry on.

Use the Desktop app for `/handoff`. In the terminal chat, Hermes 0.23.1 says it isn't available yet.

Part 05 / 06

## /rewind

Go back to an earlier message when a chat goes the wrong way. The wrong turns leave the chat, so they stop confusing your agent.

STEP 17

### Open the list and pick a message

Your chat

In the chat, type:

```
/rewind
```

Or press **Esc** twice on an empty message box.

Choose the message to go back to and press **Enter**. It comes back in the message box. Edit it and send. Everything after that message is removed from the chat.

Want to keep the original chat? In the terminal chat, press **F** instead of Enter. Hermes makes a copy of the chat from that point, and the original stays as it was.

**Check:** the chat now ends at the message you picked.

Part 06 / 06

## The Desktop app in a browser tab (Webapp)

The full Desktop app in any browser, with nothing to install on that computer. Turn it on first (steps 18 and 19), then pick Option A without Tailscale or Option B with Tailscale.

STEP 18

### Turn the Webapp on

Your server

```
hermes config set webapp.enabled true
```

Or paste into Hermes

```
Turn on the Hermes Webapp on this server (webapp.enabled true). Don't restart the
gateway yourself. When you're done, tell me to run: hermes gateway restart
```

Then run step 19.

STEP 19

### Restart the gateway

Your server

```
hermes gateway restart
```

STEP 20

### Option A (without Tailscale): open a tunnel

Your own computer

Using Tailscale? Skip to step 22.

```
ssh -L 9120:127.0.0.1:9120 root@YOUR-SERVER-IP
```

This logs you in to the server. Keep this window open.

STEP 21

### Option A: get your link

In that same window

```
hermes webapp --no-open
```

The first time, it builds the app. That takes a few minutes.

**Check:** it prints a link. Open it in your browser within 60 seconds. You see the Desktop app in a tab.

STEP 22

### Option B (with Tailscale): put Tailscale on your server (once)

Your server

```
curl -fsSL https://tailscale.com/install.sh | sh
```

Or paste into Hermes

```
Set up the Hermes Webapp for my Tailscale network. Install Tailscale on this server
and give me the sign-in link. Serve http://127.0.0.1:9120 with tailscale serve on
https port 8443, then set webapp.public_url to that address. Don't restart the
gateway yourself. When you're done, tell me to run: hermes gateway restart
```

Instead of steps 22 to 26.

STEP 23

### Option B: sign in to Tailscale

Your server

```
sudo tailscale up
```

Open the link it prints and sign in.

STEP 24

### Option B: give the Webapp a private address (once)

Your server

```
sudo tailscale serve --bg --https=8443 http://127.0.0.1:9120
```

It prints your address. Example: `https://myserver.tail1234.ts.net:8443`

Does it ask you to turn on HTTPS? Open the link it gives you and click Enable.

STEP 25

### Option B: tell Hermes that address (once)

Your server

```
hermes config set webapp.public_url https://myserver.tail1234.ts.net:8443
```

STEP 26

### Option B: restart the gateway

Your server

```
hermes gateway restart
```

STEP 27

### Option B: get your link (every time)

Your server

```
hermes webapp --no-open
```

**Check:** open the link within 60 seconds on any device with Tailscale on, your phone included.

STEP 28

### Sign out every browser tab

Your server

```
hermes webapp --sign-out
```

// Stay safe

## Stay safe

Never open ports 9119 or 9120 to the internet. A signed-in tab can run commands on your server.

Never share the key file without .pub (your private key). The .pub file is safe to copy.

The 60-second Webapp link works once. Don't paste it into chats.

// If something goes wrong

## Common problems and fixes

Save connection stays grey: the Name field is empty. Type a name.

Remote gateway Test fails: the address has a / at the end or no https://. Copy it again as in step 3.

hermes: command not found: your terminal opened before the install. Log out and back in.

It still asks for a password after copying the key: your key has another name than id_ed25519. Go back to step 5.

Connection reset by peer: your server blocks you for a few minutes after failed logins. Wait 10 minutes, then try once.

Desktop Test can't find Hermes over SSH: put /root/.local/bin/hermes in Hermes path. Not logged in as root? Use /home/YOUR-USER/.local/bin/hermes.

"can't host a bot for a group chat on another computer yet": Hermes on that server stops when Desktop closes. Run step 10, then click Retry.

Desktop says the group will live on another setup: you picked bots from a setup you haven't switched to. Switch to it first (step 10).

/handoff says there is no home channel: send /sethome to your bot in Telegram (step 15).

"/handoff is not available on the shared gateway yet": you typed it in the terminal chat. Use the Desktop app.

"The gateway started before the Webapp was turned on": run hermes gateway restart, then hermes webapp --no-open again.

"channel 3: open failed: connect failed: Connection refused": the tunnel works, but nothing runs on that port yet. Run hermes webapp --no-open.

"REMOTE HOST IDENTIFICATION HAS CHANGED": your server was reinstalled. Run ssh-keygen -R YOUR-SERVER-IP, then connect again.

// Glossary

## What the parts of the commands mean

ssh-keygen -t ed25519: make a key pair, a private key and a .pub key.

ssh-copy-id: copy your .pub key to the server's list of allowed keys.

~/.ssh: the folder where your computer keeps its keys.

gateway install --system: run Hermes as a service that starts with the server.

/sethome: make this Telegram chat the place where handoffs land.

-L 9120:127.0.0.1:9120: your computer's port 9120 leads to the server's port 9120.

127.0.0.1: "this machine only". Nothing outside can reach it.

--no-open: print the link instead of opening a browser on the server.

tailscale serve --bg: share a page inside your Tailscale network only, in the background.

--https=8443: the port of the private HTTPS address.

## // What you set up

Every Hermes you run in one Desktop app (Hostinger, Tailscale, any VPS over SSH). Group chats with your bots. A lead bot, or Hermes picks who answers. A chat that moves from Desktop to Telegram with /handoff. /rewind for a chat that went the wrong way. The Desktop app in a browser tab.

Stuck on a step? Drop a comment on the video, or book a session and we'll walk through it together.

### Usage & License

Use the prompts and downloadable templates on this page in your own personal and commercial projects. What's not allowed: reselling, repackaging, redistributing, or republishing this material — on YouTube, Gumroad, paid courses, newsletters, or anywhere else. Send people to https://komputermechanic.com/ instead. Violations get reported and taken down.

## Structured data

```json
[
  {
    "@context": "https://schema.org",
    "@type": "Article",
    "headline": "Hermes Hearth Update: Every New Feature, Step by Step",
    "description": "Set up the Hermes v0.23 Hearth update step by step: every Hermes in one Desktop app, bot group chats, who answers, /handoff to Telegram, /rewind and the Webapp in a browser.",
    "image": "https://img.youtube.com/vi/6RHJaYsldxU/maxresdefault.jpg",
    "url": "https://komputermechanic.com/tutorials/hermes-hearth-update",
    "datePublished": "2026-11-18",
    "author": {
      "@type": "Organization",
      "name": "Komputer Mechanic",
      "url": "https://komputermechanic.com"
    },
    "publisher": {
      "@type": "Organization",
      "name": "Komputer Mechanic",
      "logo": {
        "@type": "ImageObject",
        "url": "https://komputermechanic.com/favicon.png"
      }
    },
    "mainEntityOfPage": "https://komputermechanic.com/tutorials/hermes-hearth-update",
    "keywords": [
      "Hermes Agent",
      "Hermes Desktop",
      "Hearth",
      "Telegram",
      "Tailscale",
      "SSH"
    ]
  },
  {
    "@context": "https://schema.org",
    "@type": "VideoObject",
    "name": "Hermes Hearth Update: Every New Feature, Step by Step",
    "description": "Set up the Hermes v0.23 Hearth update step by step: every Hermes in one Desktop app, bot group chats, who answers, /handoff to Telegram, /rewind and the Webapp in a browser.",
    "thumbnailUrl": "https://img.youtube.com/vi/6RHJaYsldxU/maxresdefault.jpg",
    "uploadDate": "2026-11-18",
    "contentUrl": "https://www.youtube.com/watch?v=6RHJaYsldxU",
    "embedUrl": "https://www.youtube.com/embed/6RHJaYsldxU"
  },
  {
    "@context": "https://schema.org",
    "@type": "BreadcrumbList",
    "itemListElement": [
      {
        "@type": "ListItem",
        "position": 1,
        "name": "Home",
        "item": "https://komputermechanic.com/"
      },
      {
        "@type": "ListItem",
        "position": 2,
        "name": "Tutorials",
        "item": "https://komputermechanic.com/tutorials"
      },
      {
        "@type": "ListItem",
        "position": 3,
        "name": "Hermes Hearth update"
      }
    ]
  }
]
```