.env file. Copy .env.example to .env and update values for your environment.
Database
PostgreSQL (Primary)
| Variable | Description | Default |
|---|---|---|
TYPEORM_HOST | Database host | db |
TYPEORM_PORT | Database port | 5432 |
TYPEORM_USERNAME | Database user | shoptokenadmin |
TYPEORM_PASSWORD | Database password | shoptoken123 |
TYPEORM_DATABASE | Database name | shoptoken |
TYPEORM_MIGRATIONS | Migration file path | db/postgres/migrations/*.ts |
TYPEORM_MIGRATIONS_DIR | Migration output directory | db/postgres/migrations |
ClickHouse (Analytics)
| Variable | Description | Default |
|---|---|---|
CLICKHOUSE_HOST | ClickHouse host | clickhouse |
CLICKHOUSE_DATABASE | Database name | ltvai |
CLICKHOUSE_USERNAME | ClickHouse user | ltvaiadmin |
CLICKHOUSE_PASSWORD | ClickHouse password | ltvai123 |
CLICKHOUSE_PORT | HTTP port | 8123 |
Redis
| Variable | Description | Default |
|---|---|---|
REDIS_HOST | Redis host | redis |
REDIS_PORT | Redis port | 6379 |
REDIS_PASSWORD | Redis password | redispassword |
REDIS_USE_TLS | Enable TLS | false |
Authentication
JWT Secrets
| Variable | Description |
|---|---|
RETAILER_JWT_PRIVATE_KEY | Secret for retailer (merchant) tokens |
ADMIN_JWT_PRIVATE_KEY | Secret for admin panel tokens |
BRIDGE_JWT_PRIVATE_KEY | Secret for cross-service bridge tokens |
PORTAL_JWT_PRIVATE_KEY | Secret for merchant portal SSO tokens |
Ecommerce Integrations
Shopify
| Variable | Description |
|---|---|
SHOPIFY_API_KEY | Shopify app API key |
SHOPIFY_API_SECRET_KEY | Shopify app secret |
BigCommerce
| Variable | Description |
|---|---|
BIGCOMMERCE_CLIENT_ID | BigCommerce app client ID |
BIGCOMMERCE_CLIENT_SECRET | BigCommerce app secret |
Email & Communication
| Variable | Description |
|---|---|
SENDGRID_API_KEY | SendGrid API key for email delivery |
SENDGRID_SUBUSER_EMAIL_PREFIX | SendGrid subuser prefix |
AWS Services
SQS Queues
| Variable | Description |
|---|---|
SQS_QUEUE_EMAIL_ANALYTICS | Email analytics processing |
SQS_QUEUE_WEBHOOK_EVENTS | Webhook event processing |
SQS_QUEUE_SCHEDULES | Email scheduling |
SQS_QUEUE_OUTGOING_WEBHOOKS | Outgoing webhook delivery |
SQS_QUEUE_SEGMENTATION_REQUESTS | Segmentation processing |
SQS_QUEUE_CATALOG_UPDATES | Product catalog sync (FIFO) |
SQS_QUEUE_EXTERNAL_PROFILE_PUSH_SYNC | External profile sync |
SQS_QUEUE_OUTREACH_INBOUND_EMAILS | Inbound email processing |
SQS_QUEUE_INBOX_INBOUND_EMAILS | Inbox email processing |
Other AWS
| Variable | Description |
|---|---|
AWS_BATCH_JOB_QUEUE_NAME | AWS Batch job queue |
AWS_BATCH_JOB_DEFINITION_NAME_SEGMENT_SYNC | Segment sync job definition |
Application
| Variable | Description | Default |
|---|---|---|
ENV | Environment name | development |
LOCAL | Running locally flag | true |
LOG_LEVEL | Logging level | debug |
LOG_PRETTY | Pretty print logs | true |
USE_NEST_LOGGER | Use NestJS built-in logger | false |
SELF_URL | Backend self-referencing URL | - |
RETAILER_UI_URL | Retailer dashboard URL | - |
WEB_JS_URL | Frontend widget JS URL | - |
PORTAL_URL | Merchant portal URL | - |
Slack Webhooks
| Variable | Description |
|---|---|
APP_INSTALLS_SLACK_WEBHOOK_URL | New app install notifications |
SEQUENCE_UPDATES_SLACK_WEBHOOK_URL | Sequence update notifications |
WAITLIST_JOINED_SLACK_WEBHOOK_URL | Waitlist join notifications |