From 99cee124dc446a087684a48c3eafea837c04f67a Mon Sep 17 00:00:00 2001 From: bedirhancode Date: Fri, 5 Jun 2026 03:49:55 +0300 Subject: [PATCH] docs(install): warn that VPS browser consoles mangle special chars (#36279) (#38811) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Some VPS providers (Hetzner Cloud and others) offer a browser-based console for managing hosts. These consoles transmit special characters incorrectly — ':' may arrive as ';', '@' may be mis-rendered, and non-English keyboard layouts fare worse — which silently corrupts 'docker run' arguments like '-v ~/.hermes:/opt/data', '-e KEY=value', and pasted API keys / tokens. Adds a :::caution admonition above the Quick start 'docker run' block in website/docs/user-guide/docker.md recommending SSH for copy-paste- safe command entry, with manual-typing guidance as a fallback. Pure docs change, no code touched. Closes #36279 Co-authored-by: Bedirhan Celayir --- website/docs/user-guide/docker.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/website/docs/user-guide/docker.md b/website/docs/user-guide/docker.md index de1e5587f..c86fff431 100644 --- a/website/docs/user-guide/docker.md +++ b/website/docs/user-guide/docker.md @@ -17,6 +17,19 @@ This page covers option 1. The container stores all user data (config, API keys, If this is your first time running Hermes Agent, create a data directory on the host and start the container interactively to run the setup wizard: +:::caution Avoid browser-based VPS consoles for the install commands +Some VPS providers (Hetzner Cloud, and several others) offer a browser-based +console for managing hosts. These consoles transmit special characters +incorrectly — `:` may arrive as `;`, `@` may be mis-rendered, and non-English +keyboard layouts fare worse — which silently corrupts `docker run` arguments +like `-v ~/.hermes:/opt/data`, `-e KEY=value`, and pasted API keys / tokens. + +**Connect over SSH instead** (`ssh root@`) for copy-paste-safe command +entry. If you must use the browser console, type the commands manually +instead of pasting, and double-check every `:`, `@`, `=`, and `/` in the +result before hitting Enter. +::: + ```sh mkdir -p ~/.hermes docker run -it --rm \