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/logs.md. Product capabilities: skill.md. Docs MCP: /docs/mcp. Site MCP: /mcp.
Logs
Set up, configure, and run the Reloop logs microservice locally.
Event logging and analytics: activity logs and email delivery data in PostgreSQL.
Overview
| Property | Value |
|---|---|
| Directory | apps/backend/logs |
| Port | 8016 |
| Local URL | https://local.reloop.sh/api/logs |
| Swagger UI | https://local.reloop.sh/api/logs/openapi |
| Stack | ElysiaJS · PostgreSQL · Redis · NATS |
Quick start
bun run --filter=be-logs devOr bun backend:dev / bun dev.
Environment
apps/backend/logs/.env (from bun setup / bun env:setup).
PG_URL=postgresql://reloop:reloop123@localhost:5432/reloop
REDIS_URL=redis://:reloop123@localhost:6379
PORT=8016
BASE_URL="https://local.reloop.sh"
NATS_URL=nats://localhost:4222
NODE_ENV=development| Variable | Required | Default |
|---|---|---|
PG_URL | YES | postgresql://reloop:reloop123@localhost:5432/reloop |
REDIS_URL | YES | redis://... |
PORT | YES | 8016 |
NATS_URL | YES | nats://localhost:4222 |
Commands
| Command | Description |
|---|---|
bun run --filter=be-logs dev | Start dev server with hot reloading |
bun run --filter=be-logs build | Compile production bundle |
bun run --filter=be-logs start | Run compiled production build |
bun run --filter=be-logs check-types | TypeScript type-check |
Architecture
| Layer | Detail |
|---|---|
| Ingestion | Subscribes to NATS delivery and activity events |
| Storage | Writes activity logs to Postgres activity_log; email delivery to email_log |
| Query API | Powers dashboard activity logs and email delivery analytics |
| Schema | Defined in packages/db/src/schema/activity-log.ts |
Next
Was this page helpful?