reloopsh/be-domain repository overview

⁠🌐 Reloop — Domain Service

The Domain Service is the sending domain management microservice in the Reloop⁠ platform. It handles everything needed to set up and verify custom sending domains — including DNS record generation, DKIM key pair management, MX record configuration, and domain verification status tracking.

Built on Bun⁠ + Elysia⁠, backed by PostgreSQL and Redis.

⁠🚀 Features

• Domain Registration — Add and manage custom sending domains per organization
• DKIM Key Management — Auto-generates 2048-bit DKIM key pairs per domain
• DNS Record Generation — Produces ready-to-copy SPF, DKIM, MX, and DMARC records
• Domain Verification — Checks and tracks DNS propagation status
• MX Configuration — Configures inbound MX routing with priority support
• Organization-scoped — All domains are isolated per org
• OpenAPI Docs — Auto-generated spec at /api/domain/openapi
• OpenTelemetry — Full distributed tracing support
• NATS Bus — Event-driven integration via the Reloop message bus

⁠🔗 Quick Links

⁠⚡ Quick Start

docker pull reloopsh/be-domain:latest

docker run -d \
  -p 8011:8011 \
  -e PG_URL=postgresql://user:password@host:5432/reloop \
  -e REDIS_URL=redis://:password@host:6379 \
  -e NATS_URL=nats://host:4222 \
  -e BASE_URL=https://your-domain.com \
  -e HOST_DOMAIN=reloop.sh \
  -e DKIM_SELECTOR=reloop \
  reloopsh/be-domain:latest

The service will be available at http://localhost:8011/api/domain.

⁠🔧 Environment Variables

⁠🛠 Tech Stack

• Runtime: Bun⁠
• Framework: Elysia⁠
• Database: PostgreSQL via Drizzle ORM⁠
• Cache: Redis
• Messaging: NATS
• Observability: OpenTelemetry (OTLP)

⁠📦 Part of the Reloop Platform

This image is one of several microservices that make up the Reloop backend. See the full list at hub.docker.com/u/reloopsh⁠.