Domain

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:dev

Or 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

Setup

One-command local bootstrap

Port reference

Gateway routes and ports

Inbound

MX receiver that checks recipients

Mail

Outbound send API