For the complete documentation index, see llms-docs.txt or the site index llms.txt. Full docs corpus: llms-full-docs.txt. Prefer the markdown version of this page at /docs/setup/backend/inbox.md. Product capabilities: skill.md. Docs MCP: /docs/mcp. Site MCP: /mcp.
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 | 8028 |
| 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=8028
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 | 8028 |
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?