Skip to content

docs(security): add network egress isolation guide for Docker deployments - #26385

Merged
benbarclay merged 1 commit into
NousResearch:mainfrom
Manzela:docs/network-egress-isolation
May 29, 2026
Merged

docs(security): add network egress isolation guide for Docker deployments#26385
benbarclay merged 1 commit into
NousResearch:mainfrom
Manzela:docs/network-egress-isolation

Conversation

@Manzela

@Manzela Manzela commented May 15, 2026

Copy link
Copy Markdown
Contributor

Summary

Adds a guide for isolating network egress in Docker deployments of Hermes.

The default docker-compose.yml uses network_mode: host, which gives the agent container unrestricted outbound access. This is fine for development, but in production (especially with gateway-attached or unattended setups) it leaves the door open for prompt injection attacks that exfiltrate data via arbitrary HTTP requests from tool-generated shell commands.

The guide shows two approaches:

  1. Basic: Replace network_mode: host with two Docker bridge networks (internal + egress), keeping the agent on the internal-only network.
  2. With proxy: Route outbound traffic through a Squid proxy with an explicit domain allowlist (OpenAI, Anthropic, OpenRouter, Telegram, etc.).

Includes validation commands to confirm isolation is working, and documents known limitations (DNS resolution, sandbox backend interaction).

Changes

  • docs/security/network-egress-isolation.md: New file (195 lines)

Backward Compatibility

Documentation only. No code changes, no dependency changes. The existing docker-compose.yml is unchanged.

Validation

  • All compose snippets validated with docker compose config
  • Architecture diagram and allowlist tested against a local Squid instance
  • Verification commands confirmed working on Docker 27.x / Compose v2.35

Related

Complements SECURITY.md §2 trust model documentation.

@daimon-nous daimon-nous Bot added type/docs Documentation improvements P3 Low — cosmetic, nice to have area/docker Docker image, Compose, packaging type/security Security vulnerability or hardening and removed type/security Security vulnerability or hardening labels May 15, 2026
@benbarclay
benbarclay merged commit 90f0f32 into NousResearch:main May 29, 2026
KKT-OPT pushed a commit to KKT-OPT/hermes-agent that referenced this pull request May 31, 2026
T02200059 pushed a commit to T02200059/hermes-agent that referenced this pull request Jun 18, 2026
waefrebeorn pushed a commit to waefrebeorn/slermes that referenced this pull request Jul 2, 2026
santhreal pushed a commit to santhreal/hermes-agent that referenced this pull request Jul 13, 2026
donbowman pushed a commit to donbowman/hermes-agent that referenced this pull request Jul 13, 2026
Gravezzz pushed a commit to Gravezzz/hermes-agent that referenced this pull request Jul 21, 2026
leewenjie pushed a commit to leewenjie/hermes-agent that referenced this pull request Aug 7, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/docker Docker image, Compose, packaging P3 Low — cosmetic, nice to have type/docs Documentation improvements

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants