.env.example on GitHub
Required Settings
Application
DATABASE_URL
PostgreSQL connection string. Ringee uses Prisma ORM.
REDIS_URL
REDIS_HOST
REDIS_PORT
FRONTEND_URL
URL where the admin frontend is served.
BACKEND_URL / PUBLIC_BACKEND_URL
URL where the backend API is served.
APP_ENCRYPTION_SECRET
A random string used for encrypting sensitive data at the application level. Should be unique per installation.
Authentication (Clerk)
See the Clerk Configuration guide for setup details.| Variable | Description |
|---|---|
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY | Clerk publishable key |
CLERK_PUBLISHABLE_KEY | Clerk publishable key (backend) |
CLERK_SECRET_KEY | Clerk secret key |
CLERK_WEBHOOK_SIGNING_SECRET | Webhook signing secret |
NEXT_PUBLIC_CLERK_SIGN_IN_URL | Sign-in page URL (default: /auth/sign-in) |
NEXT_PUBLIC_CLERK_SIGN_UP_URL | Sign-up page URL (default: /auth/sign-up) |
NEXT_PUBLIC_CLERK_AFTER_SIGN_IN_URL | Redirect after sign-in (default: /dashboard/overview) |
NEXT_PUBLIC_CLERK_AFTER_SIGN_UP_URL | Redirect after sign-up (default: /dashboard/overview) |
Telephony (Telnyx)
See the Telnyx Configuration guide for setup details.| Variable | Description |
|---|---|
TELNYX_API_KEY | Your Telnyx API key |
TELNYX_CONNECTION_ID | Telnyx WebRTC connection ID |
TELNYX_SIP_USER | SIP username for WebRTC |
TELNYX_SIP_PASSWORD | SIP password for WebRTC |
NEXT_PUBLIC_TELNYX_LOGIN | SIP login exposed to frontend |
NEXT_PUBLIC_TELNYX_PASSWORD | SIP password exposed to frontend |
Payments (Stripe)
See the Stripe Configuration guide for setup details.| Variable | Description |
|---|---|
STRIPE_SECRET_KEY | Your Stripe secret key |
STRIPE_WEBHOOK_SECRET | Stripe webhook signing secret |
Email (Resend)
See the Email Configuration guide for details.| Variable | Description |
|---|---|
RESEND_API_KEY | Your Resend API key |
EMAIL_FROM_ADDRESS | Sender email address |
EMAIL_FROM_NAME | Sender display name |
Storage (Cloudflare R2)
See the R2 Configuration guide for details.| Variable | Description |
|---|---|
CLOUDFLARE_BUCKETNAME | R2 bucket name |
CLOUDFLARE_ACCOUNT_ID | Cloudflare account ID |
CLOUDFLARE_ACCESS_KEY | R2 access key |
CLOUDFLARE_SECRET_ACCESS_KEY | R2 secret access key |
CLOUDFLARE_BUCKET_URL | Public bucket URL |
CLOUDFLARE_REGION | Region (default: auto) |
STORAGE_PROVIDER | Storage provider (default: cloudflare) |
Optional Settings
Frontend
| Variable | Description |
|---|---|
NEXT_PUBLIC_API_BASE_URL | Backend API URL for the frontend |
NEXT_PUBLIC_SITE_URL | Public site URL |
NEXT_PUBLIC_APP_ENV | App environment (development / production) |
Sentry (Error Tracking)
| Variable | Description |
|---|---|
NEXT_PUBLIC_SENTRY_DSN | Sentry DSN |
NEXT_PUBLIC_SENTRY_ORG | Sentry organization slug |
NEXT_PUBLIC_SENTRY_PROJECT | Sentry project slug |
SENTRY_AUTH_TOKEN | Sentry auth token |
NEXT_PUBLIC_SENTRY_DISABLED | Disable Sentry (true / false) |
AI
| Variable | Description |
|---|---|
OPENAI_API_KEY | OpenAI API key (used for AI features) |