Deployment Guide — Aurora Continuum
Aurora Continuum runs as two Docker containers (backend API + frontend) alongside a MongoDB database. This guide covers pulling the images, configuring the environment, and running in production.
Prerequisites
- Docker Engine 24+ (or Docker Desktop)
- A valid Aurora Continuum license key
Quick start
Download docker-compose.prod.yml from the latest GitHub release, then run:
export GITHUB_OWNER=selectred
export JWT_SECRET=$(openssl rand -base64 32)
export FRONTEND_SECRET=$(openssl rand -base64 32)
docker compose -f docker-compose.prod.yml up -d
On first startup, Aurora Continuum automatically seeds the database with demo data so you can explore the product immediately — no manual step required.
Open http://localhost:82 to access the web UI.
Demo credentials
| Role | Password | |
|---|---|---|
| Admin | admin@continuum.aurora | admin123 |
| Manager | sarah.chen@testtracker.com | password123 |
| Engineer | john.doe@testtracker.com | password123 |
> Change the admin password after first login via Settings → Profile.
Removing demo data
When you are ready to use Aurora Continuum with real data, remove the demo content while keeping your admin account intact:
- Log in as admin
- Go to Settings → System Settings
- Click Reset Demo Data and confirm
This deletes all demo users, teams, test results, and synthetic transactions. Your admin account is preserved.
Environment variables
| Variable | Required | Description |
|---|---|---|
JWT_SECRET | Yes | Secret key for signing auth tokens — generate with openssl rand -base64 32 |
FRONTEND_SECRET | Yes | Shared secret between frontend and backend — generate with openssl rand -base64 32 |
MONGODB_URI | No | MongoDB connection string (default: mongodb://mongodb:27017/continuum) |
PORT | No | Backend API port (default: 3002) |
CORS_ORIGIN | No | Allowed frontend origin (default: http://localhost:82) |
JWT_EXPIRES_IN | No | Token expiry (default: 7d) |
Ports
| Service | Default port |
|---|---|
| Frontend (web UI) | 82 |
| Backend (API) | 3002 |
| MongoDB | 27018 (mapped from internal 27017) |
Docker Compose (production)
The docker-compose.prod.yml file pulls pre-built images from GitHub Container Registry. No source code is required.
services:
mongodb:
image: mongo:6.0
backend:
image: ghcr.io/selectred/aurora-continuum-backend:latest
environment:
JWT_SECRET: your-secret-here
MONGODB_URI: mongodb://mongodb:27017/continuum
frontend:
image: ghcr.io/selectred/aurora-continuum-frontend:latest
To pin a specific version, set VERSION before running:
export VERSION=1.2.3
docker compose -f docker-compose.prod.yml up -d
Updating
docker compose -f docker-compose.prod.yml pull
docker compose -f docker-compose.prod.yml up -d
Your data is stored in the mongodb_data Docker volume and is not affected by updates.
License activation
Once logged in, go to Settings > License and enter your license key. Keys follow the format CONTINUUM-<TIER>-<XXXXXX> (e.g. CONTINUUM-PRO-ABC123).
See docs/PRICING.md for tier limits and pricing.
Local development
To run from source instead of pulling images:
git clone <repo>
cd aurora-continuum
docker compose up -d
Or without Docker:
# Backend
cd backend && npm run dev
# Frontend (separate terminal)
cd frontend && npm run dev