Quick Start

Prerequisites

Docker Engine 24+ and Docker Compose v2
2 vCPU / 4 GB RAM / 40 GB SSD recommended baseline
Linux VPS (Ubuntu 22.04+ recommended) or local machine with Docker Desktop
Domain + reverse proxy for production (80/443)

Security baseline:

Expose only 80/443 publicly
Keep 3000, 3001, and 5432 private
Use a strong BETTER_AUTH_SECRET

Clone Repository

git clone https://github.com/redpangilinan/crikket
cd crikket

Create Env Files

cp .env.example .env
cp apps/server/.env.example apps/server/.env
cp apps/web/.env.example apps/web/.env

Configure App Env

Root .env is Docker-only (ports and bundled Postgres config).

App settings belong in:

apps/server/.env
apps/web/.env

For production, set these explicitly:

DATABASE_URL
BETTER_AUTH_SECRET (32+ characters)
NEXT_PUBLIC_APP_URL
NEXT_PUBLIC_SERVER_URL
BETTER_AUTH_URL
CORS_ORIGINS
GOOGLE_CLIENT_ID
GOOGLE_CLIENT_SECRET
ENABLE_PAYMENTS (false)

Optional but recommended for security:

CAPTURE_SUBMIT_TOKEN_SECRET
UPSTASH_REDIS_REST_URL
UPSTASH_REDIS_REST_TOKEN
TURNSTILE_SITE_KEY
TURNSTILE_SECRET_KEY

Start Stack

Prebuilt images (default):

docker compose up -d

Local source build:

docker compose -f docker-compose.yml -f docker-compose.build.yml up -d --build

Validate Deployment

docker compose ps
docker compose logs -f server
docker compose logs -f web

Schema migrations run automatically through the migrate service before server starts.

Next: Production Setup.