Skip to main content

Configuration File

Edit docker/endpoint-api/.endpoint.env before starting the service.

Required Variables

VariableDefaultDescription
SECRETrpd_pksJWT signing secret — must be identical across all services
POSTGRES__HOSTpostgresPostgreSQL host
POSTGRES__DB_NAMEendpoint_dbDatabase name
POSTGRES__AUTH__USERrapida_userDatabase user
POSTGRES__AUTH__PASSWORDDatabase password
REDIS__HOSTredisRedis host (job queue for retries)

Service Identity

VariableDefaultDescription
SERVICE_NAMEendpoint-apiInternal service label
HOST0.0.0.0Bind address
PORT9005HTTP / gRPC port
LOG_LEVELdebugdebug · info · warn · error
ENVdevelopmentdevelopment · staging · production

PostgreSQL

VariableDefaultDescription
POSTGRES__HOSTpostgresHost (localhost for local dev)
POSTGRES__PORT5432Port
POSTGRES__DB_NAMEendpoint_dbDatabase name
POSTGRES__AUTH__USERrapida_userUser
POSTGRES__AUTH__PASSWORDrapida_db_passwordPassword
POSTGRES__MAX_OPEN_CONNECTION15Connection pool size
POSTGRES__MAX_IDEAL_CONNECTION8Idle connections
POSTGRES__SSL_MODEdisabledisable · require · verify-full

Redis

VariableDefaultDescription
REDIS__HOSTredisRedis host (localhost for local dev)
REDIS__PORT6379Redis port
REDIS__DB2Redis DB index
REDIS__MAX_CONNECTION10Connection pool size

Webhook Delivery Settings

VariableDefaultDescription
WEBHOOK_MAX_RETRIES5Maximum delivery attempts per event
WEBHOOK_RETRY_DELAY5000Initial retry delay in milliseconds
WEBHOOK_TIMEOUT30000HTTP delivery timeout in milliseconds

Full Environment File

# ── Service identity ──────────────────────────────────────────────
SERVICE_NAME=endpoint-api
HOST=0.0.0.0
PORT=9005
LOG_LEVEL=debug
SECRET=rpd_pks
ENV=development

# ── PostgreSQL ────────────────────────────────────────────────────
POSTGRES__HOST=postgres
POSTGRES__PORT=5432
POSTGRES__DB_NAME=endpoint_db
POSTGRES__AUTH__USER=rapida_user
POSTGRES__AUTH__PASSWORD=rapida_db_password
POSTGRES__MAX_OPEN_CONNECTION=15
POSTGRES__MAX_IDEAL_CONNECTION=8
POSTGRES__SSL_MODE=disable

# ── Redis (retry job queue) ───────────────────────────────────────
REDIS__HOST=redis
REDIS__PORT=6379
REDIS__DB=2
REDIS__MAX_CONNECTION=10

# ── Webhook delivery settings ─────────────────────────────────────
WEBHOOK_MAX_RETRIES=5
WEBHOOK_RETRY_DELAY=5000
WEBHOOK_TIMEOUT=30000

Next Steps