Skip to content

feat: make max-outbound-peers configurable via MAX_OUTBOUND_PEERS env var#1081

Open
erhnysr wants to merge 1 commit into
base:mainfrom
erhnysr:feat/configurable-max-outbound-peers-reth
Open

feat: make max-outbound-peers configurable via MAX_OUTBOUND_PEERS env var#1081
erhnysr wants to merge 1 commit into
base:mainfrom
erhnysr:feat/configurable-max-outbound-peers-reth

Conversation

@erhnysr
Copy link
Copy Markdown

@erhnysr erhnysr commented May 14, 2026

Summary

Makes the Reth --max-outbound-peers flag configurable via a MAX_OUTBOUND_PEERS environment variable instead of being hardcoded to 100.

Problem

Operators experiencing persistent Send Queue full gossipsub warnings (#1063) need to increase the outbound peer limit to resolve the issue. However, --max-outbound-peers=100 was hardcoded in reth-entrypoint with no way to override it without modifying the entrypoint script directly.

Changes

Behaviour

No change for existing operators — default remains 100. Operators who need more peers can now set:

MAX_OUTBOUND_PEERS=250 docker compose up

Closes #1063 (partially)

… var

The --max-outbound-peers flag in reth-entrypoint was hardcoded to 100
with no way to override it without modifying the entrypoint directly.

Operators experiencing 'Send Queue full' gossipsub warnings (see base#1063)
need to increase this value to improve peer connectivity, but had no
documented way to do so.

This change:
- Adds MAX_OUTBOUND_PEERS variable to reth-entrypoint (default: 100,
  preserving existing behaviour)
- Documents the variable in .env.mainnet and .env.sepolia with a
  reference to the related issue

Fixes base#1063 (partially — the configurable peer limit addresses the
root cause for operators with port access issues)
@cb-heimdall
Copy link
Copy Markdown
Collaborator

🟡 Heimdall Review Status

Requirement Status More Info
Reviews 🟡 0/1
Denominator calculation
Show calculation
1 if user is bot 0
1 if user is external 0
2 if repo is sensitive 0
From .codeflow.yml 1
Additional review requirements
Show calculation
Max 0
0
From CODEOWNERS 0
Global minimum 0
Max 1
1
1 if commit is unverified 1
Sum 2

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.

v0.15.5 Persistent "Send Queue full" in gossipsub despite low peer count and idle bandwidth

2 participants