Docker Deployment (Optional)

Docker is an optional alternative to the default VPS + systemd + Nginx deployment. Existing systemd samples in launchkit-pro-infra remain fully supported.

Files

File	Purpose
launchkit-pro-backend/Dockerfile	Multi-stage NestJS production image
launchkit-pro-frontend/Dockerfile	Next.js production image
docker-compose.example.yml	Postgres, Redis, backend, frontend

Quick start

1. Copy the compose example:

cp docker-compose.example.yml docker-compose.yml

2. Create env files from .env.example — never commit real secrets.

3. Validate configuration:

docker compose -f docker-compose.example.yml config

4. Build and run:

docker compose up --build

• API: http://localhost:4000
• App: http://localhost:3000

Services

Service	Notes
postgres	Database — set DATABASE_URL in backend env
redis	Optional queues — set QUEUES_ENABLED=true to use
backend	Runs node dist/main.js after prisma generate + build
frontend	Runs npm run start after Next production build

An optional Nginx service is commented in the compose file for buyers who want a single edge proxy.

Production notes

• Replace placeholder passwords in compose env with secrets from your manager
• Run npx prisma migrate deploy against the container DB on first boot
• Point NEXT_PUBLIC_API_URL at your public API URL at build time for the frontend image
• For TLS and domain routing, use Nginx or a cloud load balancer in front of the containers

Related

• Deployment
• Deployment Gotchas
• Environment Variables