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 <bedirhancode@users.noreply.github.com>
This commit is contained in:
@ -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@<host>`) 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 \
|
||||
|
||||
Reference in New Issue
Block a user