Docker Guide

This repo ships both a local development compose file and a production-oriented compose file.

Local Development Compose

Start everything:

docker-compose up

Run only data services in the background:

docker compose -f infrastructure/docker/docker-compose.yml up -d postgres redis

The local compose file currently starts:

• postgres on 5432

• redis on 6379

• api on 8000

• frontend on 3000

Useful Commands

docker-compose ps
docker-compose logs -f api
docker-compose logs -f frontend
docker-compose restart api
docker-compose build api
docker-compose down
docker-compose down -v

Validate the Local Stack

Once the containers are up:

curl http://localhost:8000/health
curl http://localhost:8000/ready
open http://localhost:3000

Production Compose

The production file in this repo is:

docker-compose.production.yml

Bring it up with:

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

Inspect it with:

docker-compose -f docker-compose.production.yml ps
docker-compose -f docker-compose.production.yml logs -f api

Environment Variables

Typical values for local container work:

DATABASE_URL=postgresql://mutx:mutx_password@postgres:5432/mutx
API_HOST=0.0.0.0
API_PORT=8000
JWT_SECRET=dev-secret-change-in-production
NEXT_PUBLIC_API_URL=http://localhost:8000
NEXT_PUBLIC_SITE_URL=http://localhost:3000

Testing Notes

• The api image installs requirements.txt, not the root dev extras, so pytest is not available in that container by default.

• package.json has no test script today.

• Playwright exists, but its current config targets https://mutx.dev, not the local compose stack.

For verification, prefer host commands such as:

npm run lint
npm run build
npx playwright test --list