Getting Started

Quickstart

Get Seren running locally in under 5 minutes.

Prerequisites

Clone the repo

Clone Seren and copy the environment file.

Add your credentials

Fill in .env with Supabase URL, OAuth client IDs, and integration endpoints.

Start with Docker

One command spins up the API, Redis, Qdrant, and Neo4j.

bash

git clone https://github.com/yourname/seren
cd seren && cp .env.example .env
docker compose up -d
open http://localhost:3000

Environment Variables

.env

# Supabase
NEXT_PUBLIC_SUPABASE_URL=https://xxx.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key
DATABASE_URL=postgres://prisma.[REF]:[PASS]@[REGION].pooler.supabase.com:5432/postgres
DIRECT_URL=postgres://postgres.[REF]:[PASS]@[REGION].pooler.supabase.com:5432/postgres

# GitHub OAuth
GITHUB_CLIENT_ID=your-client-id
GITHUB_CLIENT_SECRET=your-client-secret

# PagerDuty OAuth
PAGERDUTY_CLIENT_ID=your-client-id
PAGERDUTY_CLIENT_SECRET=your-client-secret

# Sentry OAuth
SENTRY_CLIENT_ID=your-client-id
SENTRY_CLIENT_SECRET=your-client-secret

# Self-hosted (defaults)
LOKI_URL=http://localhost:3100
PROMETHEUS_URL=http://localhost:9090

Next Steps

Once the stack is up, head to the integrations docs and register your OAuth apps. Seren can start with self-hosted Loki and Prometheus first, then add GitHub, PagerDuty, and Sentry as needed.