Skip to content

Network Requirements

Before starting the Optimum Gateway, ensure your firewall allows these ports:

Required Ports

PortDirectionPurpose
33212Inboundlibp2p agent - CL clients connect here
43213Outboundmump2p agent - gateway connects to Optimum network
48123LocalhostTelemetry / Health / API — local access only (see Docker below)

Docker

Publish 33212 to the network so CL clients can connect. Bind 48123 to localhost only — metrics and health stay available on the host (e.g. local Grafana) but are not reachable from the public internet. Optimum receives telemetry via remote push; you do not need to expose 48123 externally.

bash
docker run -p 33212:33212 -p 127.0.0.1:48123:48123 \
  --name optimum-gateway \
  -e OPT_API_KEY=ogw_live_xxx \
  getoptimum/gateway:v1.0.2

If Prometheus runs in another container on the same Docker network, omit the 48123 publish and scrape the gateway by container name instead.

Verification

bash
# Check listening ports (Linux)
netstat -tlnp | grep -E "(33212|43213|48123)"

# Check listening ports (macOS)
netstat -an | grep -E "(33212|43213|48123)"

Test health:

bash
curl http://localhost:48123/health