Skip to content

feat(lighthouse): expose HTTP API port for cross-stack connectivity #402

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
nickh-obol merged 6 commits into from
Jan 15, 2026
Merged

feat(lighthouse): expose HTTP API port for cross-stack connectivity #402

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
10ed297
feat(lighthouse): expose HTTP API port for cross-stack connectivity
nickh-obol Jan 14, 2026
4d9d18b
fix(cl):expose P2P (tcp+udp) and HTTP ports for all CL clients
nickh-obol Jan 14, 2026
9e905ce
feat(charon): enables cross-stack connectivity from charon
nickh-obol Jan 14, 2026
e5bff1b
Update compose-cl.yml
nickh-obol Jan 15, 2026
d2fe5c0
Update compose-cl.yml
nickh-obol Jan 15, 2026
da073e8
feat(cl): add CL IP and port options to .env, remove holesky .env
nickh-obol Jan 15, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
231 changes: 0 additions & 231 deletions .env.sample.holesky
View file
Open in desktop

This file was deleted.

4 changes: 4 additions & 0 deletions .env.sample.hoodi
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -56,6 +56,10 @@ BUILDER_API_ENABLED=true

# CL beacon node host exposed ports.
#CL_PORT_P2P=
# To expose the beacon API to an external network, set this to the listen IP address. Use with caution.
#CL_IP_HTTP=
# Beacon node api port
#CL_PORT_HTTP

# Lighthouse becon node checkpoint sync URL used by consensus layer to fast sync.
LIGHTHOUSE_CHECKPOINT_SYNC_URL=https://checkpoint-sync.hoodi.ethpandaops.io/
Expand Down
4 changes: 4 additions & 0 deletions .env.sample.mainnet
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -56,6 +56,10 @@ BUILDER_API_ENABLED=true

# CL beacon node host exposed ports.
#CL_PORT_P2P=
# To expose the beacon API to an external network, set this to the listen IP address. Use with caution.
#CL_IP_HTTP=
# Beacon node api port
#CL_PORT_HTTP

# Lighthouse becon node checkpoint sync URL used by consensus layer to fast sync.
LIGHTHOUSE_CHECKPOINT_SYNC_URL=https://mainnet.checkpoint.sigp.io/
Expand Down
22 changes: 17 additions & 5 deletions compose-cl.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,9 @@ services:
- --builder-url=http://${MEV}:18550
- --max-empty-slots=4096
ports:
- ${CL_PORT_P2P:-9000}:9000 # P2P TCP+UDP
- ${CL_PORT_P2P:-9000}:9000/tcp
- ${CL_PORT_P2P:-9000}:9000/udp
- ${CL_IP_HTTP:-127.0.0.1}:${CL_PORT_HTTP:-5052}:5052
volumes:
- ./data/cl-grandine:/root/.grandine
- ./jwt:/jwt:ro
Expand Down Expand Up @@ -66,7 +68,9 @@ services:
--metrics-port=5054
--metrics-allow-origin="*"
ports:
- ${CL_PORT_P2P:-9000}:9000 # P2P TCP+UDP
- ${CL_PORT_P2P:-9000}:9000/tcp
- ${CL_PORT_P2P:-9000}:9000/udp
- ${CL_IP_HTTP:-127.0.0.1}:${CL_PORT_HTTP:-5052}:5052
volumes:
- ./data/lighthouse:/opt/app/beacon # Keep data in lighthouse and not cl-lighthouse for backwards compatibility
- ./jwt:/opt/jwt
Expand All @@ -80,7 +84,7 @@ services:

cl-teku:
profiles: [cl-teku]
image: consensys/teku:${VC_VERSION:-25.12.0}
image: consensys/teku:${CL_TEKU_VERSION:-25.12.0}
restart: unless-stopped
labels:
- "alloy-monitored=${CL_TEKU_ALLOY_MONITORED:-true}"
Expand All @@ -99,6 +103,10 @@ services:
--metrics-interface=0.0.0.0
--metrics-port=5054
--metrics-host-allowlist="*"
ports:
- ${CL_PORT_P2P:-9000}:9000/tcp
- ${CL_PORT_P2P:-9000}:9000/udp
- ${CL_IP_HTTP:-127.0.0.1}:${CL_PORT_HTTP:-5052}:5052
volumes:
- ./data/cl-teku:/opt/teku/data
- ./jwt:/jwt:ro
Expand All @@ -112,7 +120,7 @@ services:

cl-lodestar:
profiles: [cl-lodestar]
image: chainsafe/lodestar:${VC_VERSION:-v1.38.0}
image: chainsafe/lodestar:${CL_LODESTAR_VERSION:-v1.38.0}
restart: unless-stopped
labels:
- "alloy-monitored=${CL_LODESTAR_ALLOY_MONITORED:-true}"
Expand All @@ -131,7 +139,11 @@ services:
--metrics
--metrics.address=0.0.0.0
--metrics.port=5054
ports:
- ${CL_PORT_P2P:-9000}:9000/tcp
- ${CL_PORT_P2P:-9000}:9000/udp
- ${CL_IP_HTTP:-127.0.0.1}:${CL_PORT_HTTP:-5052}:5052
volumes:
- ./data/cl-lodestar:/opt/lodestar/data
- ./jwt:/jwt:ro
networks: [dvnode]
networks: [dvnode]
3 changes: 3 additions & 0 deletions docker-compose.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -53,6 +53,7 @@ services:
- ${LIGHTHOUSE_PORT_P2P:-9000}:9000/tcp # P2P TCP
- 5054:5054/tcp # P2P TCP
- ${LIGHTHOUSE_PORT_P2P:-9000}:9000/udp # P2P UDP
- ${LIGHTHOUSE_IP_HTTP:-127.0.0.1}:${LIGHTHOUSE_PORT_HTTP:-5052}:5052 # BN TCP
labels:
- "alloy-monitored=${LIGHTHOUSE_ALLOY_MONITORED:-true}"
command: |
Expand Down Expand Up @@ -108,6 +109,8 @@ services:
labels:
- "alloy-monitored=${CHARON_ALLOY_MONITORED:-true}"
networks: [dvnode]
extra_hosts:
- "host.docker.internal:host-gateway"
volumes:
- .charon:/opt/charon/.charon
restart: unless-stopped
Expand Down