Mail

Outbound transactional email API — send requests, template compilation, tracking, and SMTP handoff.

Run bun setup once from the monorepo root. That starts Docker including SMTP. Mailpit captures local outbound mail at http://localhost:8025.

Overview

Property	Value
Directory	`apps/backend/mail`
Port	`8015`
Local URL	https://local.reloop.sh/api/mail
Swagger UI	https://local.reloop.sh/api/mail/openapi
Stack	ElysiaJS · PostgreSQL · Redis · NATS · BullMQ

Quick start

bun be:mail:dev

Or bun backend:dev / bun dev.

Environment

apps/backend/mail/.env — from bun setup / bun env:setup.

PG_URL=postgresql://reloop:reloop123@localhost:5432/reloop
REDIS_URL=redis://:reloop123@localhost:6379
PORT=8015
BASE_URL="https://local.reloop.sh"
NATS_URL=nats://localhost:4222
KUMOMTA_HTTP_URL=http://localhost:8020
TRACKING_SECRET=reloop_tracking_secret_default_123
NODE_ENV=development

Variable	Required	Default
`PG_URL`	YES	`postgresql://...`
`REDIS_URL`	YES	`redis://...`
`PORT`	YES	`8015`
`KUMOMTA_HTTP_URL`	YES	`http://localhost:8020`
`TRACKING_SECRET`	No	Signs tracked link and open-pixel tokens
`NATS_URL`	YES	`nats://localhost:4222`

Commands

Command	Description
`bun be:mail:dev`	Start dev server with hot reloading
`bun run --filter=be-mail build`	Compile production bundle
`bun run --filter=be-mail start`	Run compiled production build
`bun run --filter=be-mail check-types`	TypeScript type-check

Architecture

Layer	Detail
Send pipeline	Validates API keys, compiles templates, injects tracking links
Queues	BullMQ workers dispatch via Redis (`mail-queue`, `mail-retry-queue`)
MTA handoff	Delivers to the SMTP engine on port `8020`
Schema	`email_log` in `packages/db/src/schema/email.ts`

Setup

One-command local bootstrap

SMTP

Outbound KumoMTA edge

Template

HTML compilation source

Links

Click and open tracking