Docker Stack (local development)
The compose stack defined in docker-compose.yml spins up the following services:
frontend-gpt: Next.js dev server published on port 3001.api-gpt: Django API on port 8000.worker-gpt/scheduler-gpt: Celery worker and beat for background jobs.db-gpt: Postgres 15 with persisted data volume (host port 5433).cache-gpt: Redis 7 for caching and Celery broker.storage-gpt: MinIO object storage (S3-compatible) with console on port 9001.
Quick start
cp infra/docker/.env.example infra/docker/.env.development # adjust secrets
docker compose up --build
The containers mount the local frontend/ and api/ folders, so code changes reload automatically.
Helper commands
docker compose exec api-gpt python manage.py migrate— run database migrations.docker compose exec api-gpt python manage.py createsuperuser— create an admin account.docker compose exec worker-gpt celery -A config.celery_app status— confirm Celery connectivity.
Notes
- MinIO credentials come from
.env.development; open http://localhost:9001 to manage buckets. - Pushbullet and Stripe keys are placeholders. Update them before testing notifications or payments.