Quickstart

This guide starts MoleSignal locally, sends a log event, and queries the event through the authenticated HTTP API.

Prerequisites

Docker and Docker Compose (the sandbox brings up Postgres + MinIO + MoleSignal).
About 2 GB of free RAM for the standalone profile.

Run the sandbox

Clone and start

git clone https://github.com/molesignal/molesignal
cd molesignal

# 1-command sandbox: Postgres + MinIO + MoleSignal standalone
docker compose -f deploy/docker/docker-compose.yaml --profile standalone up

After startup completes:

UI: http://localhost:5080
S3 admin (MinIO): http://localhost:9001 — minioadmin / minioadmin

Authenticate to obtain a JWT and org_id:

curl -X POST http://localhost:5080/api/v1/auth/signin \
  -H 'content-type: application/json' \
  -d '{"email":"[email protected]","password":"admin"}'

The response contains the JWT and org_id. Export both values for the next steps:

export MS_JWT="<jwt-from-response>"
export MS_ORG="<org_id-from-response>"

Send the first data

Native HTTP JSON intake works with curl, an app SDK, Vector, or Fluent Bit out of the box. Timestamps are microseconds since the Unix epoch.

curl -X POST http://localhost:5080/api/v1/intake/logs/app \
  -H "authorization: Bearer $MS_JWT" \
  -H 'content-type: application/json' \
  -d '[{"_timestamp":1700000000000000,"level":"error","msg":"db pool exhausted","trace_id":"abc123"}]'

Query the event

Query the app log stream over the HTTP API:

curl -X POST http://localhost:5080/api/v1/query \
  -H "authorization: Bearer $MS_JWT" \
  -H 'content-type: application/json' \
  -d "{\"org_id\":\"$MS_ORG\",\"language\":\"sql\",
       \"statement\":\"SELECT * FROM app WHERE trace_id = 'abc123'\",
       \"time_range\":{\"start\":0,\"end\":2000000000000000},
       \"stream\":{\"name\":\"app\",\"stream_type\":\"logs\"}}"

The result includes columns, rows, scanned_rows, and took_ms.

Next steps

Data intake from an existing stack

Connect OpenTelemetry, Prometheus, Loki JSON senders, Filebeat, and cloud sources.

Cross-signal correlation

Connect logs, metrics, traces, profiles, and RUM with shared context.

Deploy for real

Move from the sandbox to a multi-role or Kubernetes deployment.

Configuration

TOML config and MS_* environment overrides.

Getting Started

Observe

Reliability

AI Ops

Data

Collaboration

Admin

Deploy & Operate

Prerequisites

Run the sandbox

Next steps

Data intake from an existing stack

Cross-signal correlation

Deploy for real

Configuration

​Prerequisites

​Run the sandbox

​Next steps

Data intake from an existing stack

Cross-signal correlation

Deploy for real

Configuration

Prerequisites

Run the sandbox

Next steps