Reloop

Beta
Get Started

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.

Run bun setup once so Postgres is up (bun docker:up). Env files come from bun setup / bun env:setup.

Overview

PropertyValue
Directoryapps/backend/logs
Port8016
Local URLhttps://local.reloop.sh/api/logs
Swagger UIhttps://local.reloop.sh/api/logs/openapi
StackElysiaJS · PostgreSQL · Redis · NATS

Quick start

bun run --filter=be-logs dev

Or 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
VariableRequiredDefault
PG_URLYESpostgresql://reloop:reloop123@localhost:5432/reloop
REDIS_URLYESredis://...
PORTYES8016
NATS_URLYESnats://localhost:4222

Commands

CommandDescription
bun run --filter=be-logs devStart dev server with hot reloading
bun run --filter=be-logs buildCompile production bundle
bun run --filter=be-logs startRun compiled production build
bun run --filter=be-logs check-typesTypeScript type-check

Architecture

LayerDetail
IngestionSubscribes to NATS delivery and activity events
StorageWrites activity logs to Postgres activity_log; email delivery to email_log
Query APIPowers dashboard activity logs and email delivery analytics
SchemaDefined in packages/db/src/schema/activity-log.ts

Next

Setup

One-command local bootstrap

Port reference

Postgres and gateway ports

Mail

Source of delivery events

Webhook

Parallel event delivery path

Was this page helpful?

Edit this page
MailPreviousWorkflowNext