Hermes Agent на VPS в Docker

Составлено по документации Hermes Agent по Docker, проверено 22 октября 2026 года.

1. Выберите сервер по ресурсам. Минимум по документации: 1 ГБ памяти, 1 ядро, 500 МБ диска. Рекомендуется 2-4 ГБ, 2 ядра, от 2 ГБ диска. Если нужна работа с браузером (Chromium), берите не меньше 2 ГБ памяти и добавьте к запуску --shm-size=1g.
2. Работайте под обычным пользователем, не под root. Создайте отдельного пользователя и входите на сервер под ним.
3. Установите Docker по инструкции вашего хостинга или с официального сайта Docker и проверьте командой docker --version.
4. Сделайте первичную настройку. Создайте папку данных и запустите мастер: mkdir -p ~/.hermes, затем docker run -it --rm -v ~/.hermes:/opt/data nousresearch/hermes-agent setup. Папка ~/.hermes единственное место, где хранятся ключи, память, навыки и журналы.
5. Запустите шлюз в фоне. docker run -d --name hermes --restart unless-stopped -v ~/.hermes:/opt/data nousresearch/hermes-agent gateway run. Порт -p 8642:8642 нужен только для API агента. Для Telegram он не нужен, публиковать его не обязательно.
6. Или используйте файл docker-compose.yml.

   services:
     hermes:
       image: nousresearch/hermes-agent:latest
       container_name: hermes
       restart: unless-stopped
       command: gateway run
       volumes:
         - ~/.hermes:/opt/data
       deploy:
         resources:
           limits:
             memory: 4G
             cpus: "2.0"

   Запуск: docker compose up -d, журнал: docker compose logs -f. Это пример из документации без публикации портов.
7. Ограничьте доступ к боту. В файле ~/.hermes/.env укажите TELEGRAM_ALLOWED_USERS со своим ID и не включайте GATEWAY_ALLOW_ALL_USERS=true. Файлу секретов выдайте права chmod 600.
8. Не открывайте панель и API в интернет. Документация прямо предупреждает, что открытый порт на машине с выходом в интернет это риск. Панель управления (порт 9119) включается переменной HERMES_DASHBOARD=1, а на публичном адресе без входа через провайдера аутентификации она не запустится.
9. Обновляйте заменой образа. docker pull nousresearch/hermes-agent:latest, docker rm -f hermes, затем снова docker run с тем же томом. Для compose: docker compose pull и docker compose up -d. Данные остаются на месте, команда hermes update внутри контейнера не нужна.
10. Не запускайте два контейнера на одной папке данных и делайте копию ~/.hermes перед обновлениями. Сессии и память не рассчитаны на параллельную запись.

Дальше пройдите чек-лист безопасного запуска Hermes Agent. Хотите собрать всё это на своём сервере под руководством за один вечер? Посмотрите мини-курс «Агент на своём сервере: Hermes и OpenClaw».