Skip to main content

​
Configuration File

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

​
Required Variables

VariableDefaultDescription
SECRETrpd_pksJWT signing secret — must be identical across all services
POSTGRES__HOSTpostgresPostgreSQL host
POSTGRES__DB_NAMEintegration_dbDatabase name
POSTGRES__AUTH__USERrapida_userDatabase user
POSTGRES__AUTH__PASSWORD—Database password
REDIS__HOSTredisRedis host
INTEGRATION_CRYPTO_KEY—AES-256-GCM encryption key for provider credentials
WEB_HOSTweb-api:9001web-api gRPC address
INTEGRATION_CRYPTO_KEY protects all stored provider credentials. If this key is rotated or lost, all stored credentials become unreadable and must be re-entered through the dashboard. Store it in a secret manager (AWS Secrets Manager, HashiCorp Vault, Kubernetes Secrets) — never commit it to version control.Generate a key: openssl rand -hex 32

​
Service Identity

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

​
PostgreSQL

VariableDefaultDescription
POSTGRES__HOSTpostgresHost (localhost for local dev)
POSTGRES__PORT5432Port
POSTGRES__DB_NAMEintegration_dbDatabase name
POSTGRES__AUTH__USERrapida_userUser
POSTGRES__AUTH__PASSWORDrapida_db_passwordPassword
POSTGRES__MAX_OPEN_CONNECTION10Connection pool size
POSTGRES__SSL_MODEdisabledisable · require · verify-full

​
Redis

VariableDefaultDescription
REDIS__HOSTredisRedis host (localhost for local dev)
REDIS__PORT6379Redis port

​
Optional OAuth Variables

Used when provider OAuth flows are enabled (Google, GitHub):
VariableDescription
OAUTH_CALLBACK_URLOAuth redirect URI
GOOGLE_OAUTH_CLIENT_IDGoogle OAuth app client ID
GOOGLE_OAUTH_CLIENT_SECRETGoogle OAuth app client secret
GITHUB_OAUTH_CLIENT_IDGitHub OAuth app client ID
GITHUB_OAUTH_CLIENT_SECRETGitHub OAuth app client secret

​
Full Environment File

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

# ── PostgreSQL ────────────────────────────────────────────────────
POSTGRES__HOST=postgres
POSTGRES__PORT=5432
POSTGRES__DB_NAME=integration_db
POSTGRES__AUTH__USER=rapida_user
POSTGRES__AUTH__PASSWORD=rapida_db_password
POSTGRES__MAX_OPEN_CONNECTION=10
POSTGRES__SSL_MODE=disable

# ── Redis ─────────────────────────────────────────────────────────
REDIS__HOST=redis
REDIS__PORT=6379

# ── Credential encryption ─────────────────────────────────────────
# Generate: openssl rand -hex 32
INTEGRATION_CRYPTO_KEY=your_32_char_encryption_key_here

# ── Internal service addresses ────────────────────────────────────
WEB_HOST=web-api:9001

​
Next Steps

Adding Providers

How to implement the LargeLanguageCaller interface.

Overview

Integration API purpose and credential encryption.