Domain
Set up, configure, and run the Reloop domain microservice locally.
Custom sending domains, DKIM keys, DNS verification, and tracking subdomain setup.
Overview
| Property | Value |
|---|---|
| Directory | apps/backend/domain |
| Port | 8011 |
| Local URL | https://local.reloop.sh/api/domain |
| Swagger UI | https://local.reloop.sh/api/domain/openapi |
| Stack | ElysiaJS · PostgreSQL · Redis · NATS |
Quick start
bun be:domain:devOr bun backend:dev / bun dev.
Environment
apps/backend/domain/.env — from bun setup / bun env:setup.
PG_URL=postgresql://reloop:reloop123@localhost:5432/reloop
REDIS_URL=redis://:reloop123@localhost:6379
PORT=8011
BASE_URL="https://local.reloop.sh"
HOST_DOMAIN=reloop.sh
DKIM_SELECTOR=reloop
NATS_URL=nats://localhost:4222
NODE_ENV=development| Variable | Required | Default |
|---|---|---|
PG_URL | YES | postgresql://... |
REDIS_URL | YES | redis://... |
PORT | YES | 8011 |
BASE_URL | YES | https://local.reloop.sh |
HOST_DOMAIN | YES | reloop.sh |
DKIM_SELECTOR | YES | reloop |
NATS_URL | YES | nats://localhost:4222 |
Commands
| Command | Description |
|---|---|
bun be:domain:dev | Start dev server with hot reloading |
bun run --filter=be-domain build | Compile production bundle |
bun run --filter=be-domain start | Run compiled production build |
bun run --filter=be-domain check-types | TypeScript type-check |
Architecture
| Layer | Detail |
|---|---|
| DNS verification | Validates DKIM, SPF, DMARC, MX, and CNAME records per domain capability |
| Inbound validation | Used by inbound to verify recipient addresses |
| Schema | domain and domain_dns_record in packages/db/src/schema/domain.ts |
| Events | Publishes domain lifecycle events to NATS |
Next
Was this page helpful?
- Need help? Contact Support.
- Chat with Reloop developers on Discord.
- Check out our changelog.
- Questions? Contact Sales.
- LLM? Read llms.txt.