Skip to main content

Configuration

edgeProxy is configured entirely through environment variables. This section covers all available options with examples.

Documentation Sections​

SectionDescription
Environment VariablesCore settings, TLS, DNS, API
Database SchemaBackend routing table structure
Internal DNSGeo-aware .internal domain resolution
Auto-Discovery APIDynamic backend registration
Built-in ReplicationDistributed SQLite sync (SWIM + QUIC)
Infrastructure ComponentsRate limiting, circuit breaker, metrics

Quick Start​

Development​

export EDGEPROXY_LISTEN_ADDR="127.0.0.1:8080"
export EDGEPROXY_REGION="sa"
export EDGEPROXY_DB_PATH="./routing.db"
export DEBUG="1"

./target/release/edge-proxy

Production​

export EDGEPROXY_LISTEN_ADDR="0.0.0.0:8080"
export EDGEPROXY_REGION="sa"
export EDGEPROXY_DB_PATH="/data/routing.db"
export EDGEPROXY_BINDING_TTL_SECS="600"

./edge-proxy

Docker Compose​

services:
  pop-sa:
    image: edgeproxy:latest
    environment:
      - EDGEPROXY_REGION=sa
      - EDGEPROXY_LISTEN_ADDR=0.0.0.0:8080
      - EDGEPROXY_DB_PATH=/app/routing.db
      - EDGEPROXY_BINDING_TTL_SECS=30
    ports:
      - "8080:8080"
    volumes:
      - ./routing.db:/app/routing.db:ro