Skip to main content

Environment Variables

All configuration is via environment variables. Set them in .env for Docker Compose, or in your process environment for bare metal.

Server

VariableDefaultDescription
MCP_AUTH_TOKENBearer token for MCP tool access. If unset, auth is disabled.
MCP_PORT3100HTTP listen port
MCP_TRANSPORTstdioTransport mode: http or stdio
HTTP_BIND_HOST0.0.0.0Server bind address
DATABASE_TYPEsqlitepostgres or sqlite
POSTGRES_HOSTlocalhostPostgres host
POSTGRES_PORT5432Postgres port
POSTGRES_DBoprelayDatabase name
POSTGRES_USERoprelayDatabase user
POSTGRES_PASSWORDDatabase password (required for Postgres)
LOG_LEVELinfoPino log level
HEALTH_PORT8080Standalone health check port. Set to 0 to disable.

Dashboard & Auth

VariableDefaultDescription
BETTER_AUTH_SECRETSession signing secret (required for HTTP mode)
DASHBOARD_AUTH_TOKENDashboard API auth token
ALLOW_SELF_SIGNUPtrueAllow viewer self-registration from login page
DASHBOARD_SECURE_COOKIEStrueSecure cookie flag. Set false for localhost.
DASHBOARD_URLPublic dashboard URL (for email links)
AUTH_MODEmulti_userAuth mode: multi_user or single_user