Skip to content

DX-3179: connect Hermes Desktop to a box over SSH - #946

Merged
buggyhunter merged 15 commits into
mainfrom
DX-3179
Oct 22, 2026
Merged

buggyhunter merged 15 commits into
mainfrom
DX-3179

Conversation

@alitariksahin

@alitariksahin alitariksahin commented Oct 21, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Adds a "Connect from Hermes Desktop" step to the Hermes guide. Hermes Desktop can use a remote Hermes as its backend over SSH (Settings → Gateways → Add → SSH); it starts hermes serve in the box and tunnels to it. Desktop SSH only uses keys, so this relies on the new Box SSH keys (upstash/box-backend#298).

  • Step 2 now connects with an SSH key (linking the new SSH keys section); the API key password stays as a fallback.
  • New step 4: point ~/.ssh/config at that key for us-east-1.box.upstash.com, then add the box as an SSH gateway in Hermes Desktop.
  • Removed the init-script step (hermes gateway run) and its screenshot: Hermes Desktop starts hermes serve in the box itself.
  • Tested end to end with Hermes Desktop against a keep-alive box.

Merge order: after #944 (the /box/overall/shell#ssh-keys link) and upstash/upstash-console-v2#1609 (the console SSH Keys page).

@mintlify

mintlify Bot commented Oct 21, 2026 •

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
upstash 🟢 Ready View Preview Oct 21, 2026, 1:43 PM

💡 Tip: Enable Automations to automatically generate PRs for you.

@linear-code

linear-code Bot commented Oct 21, 2026

Copy link
Copy Markdown

DX-3179

@context7

context7 Bot commented Oct 21, 2026 •

Copy link
Copy Markdown
Contributor

Docs7 for upstash.com

Result Status Action
Deployment ✅ Ready Open preview
Content review ❌ Needs attention. 1 problem remains. View findings

Commit 291b2a1 · Updated 2026-10-21 13:48 UTC · View build details

1 finding is inline on the changed files.

@context7
context7 Bot temporarily deployed to Docs7 Preview: DX-3179 October 21, 2026 12:57 Destroyed
@context7
context7 Bot temporarily deployed to Docs7 Preview: DX-3179 October 21, 2026 13:03 Destroyed
## 2. Connect via SSH

Once the box is running, connect to it via SSH from your terminal. Use your [Box API key](/box/overall/quickstart#1-get-your-api-key) as the password when prompted.
Once the box is running, [set up an SSH key](/box/overall/shell#ssh-keys) and connect to the box from your terminal. You'll use the same key to connect from Hermes Desktop later.

This comment was marked as outdated.

@context7
context7 Bot temporarily deployed to Docs7 Preview: DX-3179 October 21, 2026 13:11 Destroyed
## 2. Connect via SSH

Once the box is running, connect to it via SSH from your terminal. Use your [Box API key](/box/overall/quickstart#1-get-your-api-key) as the password when prompted.
Once the box is running, [set up an SSH key](/box/overall/shell#ssh-keys) and connect to the box from your terminal. You'll use the same key to connect from Hermes Desktop later.

This comment was marked as outdated.

@context7
context7 Bot temporarily deployed to Docs7 Preview: DX-3179 October 21, 2026 13:35 Destroyed
@context7
context7 Bot temporarily deployed to Docs7 Preview: DX-3179 October 21, 2026 13:48 Destroyed
## 2. Connect via SSH

Once the box is running, connect to it via SSH from your terminal. Use your [Box API key](/box/overall/quickstart#1-get-your-api-key) as the password when prompted.
Once the box is running, [set up an SSH key](/box/overall/shell#ssh-keys) and connect to the box from your terminal. You'll use the same key to connect from Hermes Desktop later.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Broken links: Anchor ssh-keys does not exist on /box/overall/shell; that page only has an SSH section.

@buggyhunter
buggyhunter merged commit b5011b6 into main Oct 22, 2026
4 of 5 checks passed
@buggyhunter
buggyhunter deleted the DX-3179 branch October 22, 2026 10:03
@6zwrksrv9h-dot

Copy link
Copy Markdown
  • [ @0009-0007-5566-1998]

This branch was successfully deployed

1 active deployment
Docs7 Preview: DX-3179 — 291b2a1f Deployed Oct 21, 2026 by context7[bot]
staging — 291b2a1f Deployed Oct 21, 2026 by mintlify[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants