Docker Setup
ClearSight ships with Docker Compose configurations for both development and production.
Development
Development
The dev setup runs 5 services with live reloading:
git clone https://github.com/thepranaygupta/clearsight.git
cd clearsight
cp .env.example .env # fill in your values
pnpm docker:devServices started:
| Service | Port | Description |
|---|---|---|
app | 3000 | Next.js dev server with Turbopack |
worker | — | BullMQ processors (no port) |
postgres | 5432 | PostgreSQL 16 |
redis | 6379 | Redis 7 |
bull-board | 3001 | Queue monitoring UI |
docs | 3002 | Nextra docs site |
Source files are volume-mounted into the container — changes to src/ hot-reload immediately.
To stop:
pnpm docker:dev:downWithout Docker
If you prefer to run services manually:
# 1. Install dependencies
pnpm install
# 2. Set up the database
pnpm db:migrate
# 3. Start the Next.js app
pnpm dev
# 4. In a separate terminal, start the worker
pnpm workerRedis and PostgreSQL must be running and accessible at the URLs in your .env.
Next steps
Last updated on