Erigon Port Reference

When running multiple Erigon instances on the same machine, every listening port must be unique per instance. Erigon will fail at startup if any port is already in use, reporting bind: address already in use.

All Ports That Must Be Changed

Conditional Ports (only if enabled)

Example: Two Instances

Instance 1 (using defaults):

./build/bin/erigon --datadir /path/to/datadir1

Instance 2 (all ports offset by +100):

./build/bin/erigon --datadir /path/to/datadir2 \
  --private.api.addr=127.0.0.1:9190 \
  --http.port=8645 \
  --authrpc.port=8651 \
  --ws.port=8646 \
  --torrent.port=42169 \
  --port=30403 \
  --caplin.discovery.port=4100 \
  --caplin.discovery.tcpport=4101 \
  --sentinel.port=7877 \
  --beacon.api.port=5655 \
  --mcp.port=8653

Notes

• --private.api.addr takes a full host:port value, not just a port number.
• The torrent port binds on both TCP and UDP; it is typically the first port conflict encountered at startup.
• If --pprof or --metrics are enabled on both instances, their ports must also differ.