Skip to main content
Tracera runs as a multi-container Docker stack. You can be up and running in minutes.

​
Prerequisites

Docker

Docker and Docker Compose are required for all setups.

Go 1.24+

Required only for local backend development. Download Go

Node.js 20+

Required only for local frontend development. Download Node.js

pnpm

Required for frontend dependency management. Install pnpm

​
Quick Start

1

Clone the repository

git clone https://github.com/tracera-labs/Tracera.git
cd Tracera
2

Configure environment

cp .env.example .env
At minimum, generate a session secret:
# Generate and set SESSION_SECRET
openssl rand -base64 32
Edit .env and paste the generated value as SESSION_SECRET.
3

Start the stack

Development (with hot reload):
make docker-dev
Production:
make docker-prod
4

Access Tracera

ServiceURL
Frontendhttp://localhost:3000
Backend APIhttp://localhost:8080
Health Checkhttp://localhost:8080/api/v1/health

​
Optional Configuration

For full functionality, configure OAuth providers and email in your .env:
VariablePurpose
GOOGLE_CLIENT_ID / GOOGLE_CLIENT_SECRETGoogle OAuth login
GITHUB_CLIENT_ID / GITHUB_CLIENT_SECRETGitHub OAuth login
STEAM_API_KEYSteam profile data during OpenID login
PRICEMPIRE_API_KEYPriceEmpire price source
RESEND_API_KEY / RESEND_FROM_EMAILMagic link emails
See Environment Variables for the complete reference.

​
Stop Containers

# Development
make docker-dev-down

# Production
make docker-down

​
Next Steps

Docker Setup

Deep dive into Docker Compose configuration

Local Development

Run services outside Docker for development

Configuration

Complete environment variable reference

API Reference

Explore the REST and WebSocket APIs