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)

@cb-heimdall
Copy link
Copy Markdown
Collaborator

cb-heimdall commented May 14, 2026

🟡 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 0
Sum 1

… var

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

Operators experiencing persistent "Send Queue full" gossipsub warnings
(base#1063) need to increase this value, but had no documented way to do so.

- Add MAX_OUTBOUND_PEERS to execution-entrypoint (default: 100,
  preserving existing behaviour)
- Document the variable in .env.mainnet and .env.sepolia under a new
  PEER LIMITS section with a reference to base#1063

Closes base#1063 (partially)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@erhnysr erhnysr force-pushed the feat/configurable-max-outbound-peers-reth branch from 5cfa775 to 65df9ba Compare May 22, 2026 06:44
@erhnysr
Copy link
Copy Markdown
Author

erhnysr commented May 22, 2026

Rebased on latest main (post #1090)

This PR has been rebased onto the current main branch. The changes target the new unified execution-entrypoint (which replaced reth/reth-entrypoint in #1090).

What changed:

File Change
execution-entrypoint MAX_OUTBOUND_PEERS="${MAX_OUTBOUND_PEERS:-100}" added to var block; --max-outbound-peers=100--max-outbound-peers="$MAX_OUTBOUND_PEERS"
.env.mainnet / .env.sepolia New PEER LIMITS section documents the variable with a link to #1063

Default behaviour is unchanged — operators who don't set MAX_OUTBOUND_PEERS get 100 as before. Those hitting the Send Queue full issue can now simply add MAX_OUTBOUND_PEERS=250 to their .env file.

Happy to address any review feedback.

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