Inbox
Set up, configure, and run the Reloop inbox microservice locally.
Agent Inbox API — mailboxes, threads, and messages from inbound email via NATS.
Overview
| Property | Value |
|---|---|
| Directory | apps/backend/inbox |
| Port | 8021 |
| Local URL | https://local.reloop.sh/api/inbox |
| Swagger UI | https://local.reloop.sh/api/inbox/openapi |
| Stack | ElysiaJS · PostgreSQL · Redis · NATS |
Quick start
bun be:inbox:devOr bun backend:dev / bun dev.
Environment
apps/backend/inbox/.env — from bun setup / bun env:setup.
PG_URL=postgresql://reloop:reloop123@localhost:5432/reloop
REDIS_URL=redis://:reloop123@localhost:6379
PORT=8021
BASE_URL="https://local.reloop.sh"
NATS_URL=nats://localhost:4222
NODE_ENV=development| Variable | Required | Default |
|---|---|---|
PG_URL | YES | postgresql://... |
REDIS_URL | YES | redis://... |
PORT | YES | 8021 |
NATS_URL | YES | nats://localhost:4222 |
Commands
| Command | Description |
|---|---|
bun be:inbox:dev | Start dev server with hot reloading |
bun run --filter=be-inbox build | Compile production bundle |
bun run --filter=be-inbox start | Run compiled production build |
bun run --filter=be-inbox check-types | TypeScript type-check |
Architecture
| Layer | Detail |
|---|---|
| Inbound flow | inbound MTA → NATS → inbox persistence |
| Attachments | File storage via upload (no direct S3 config on inbox) |
| Dashboard API | Mailboxes, threads, and messages at /api/inbox |
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.