Files
pypistats.dev/README_DOCKER.md
2025-08-12 10:35:39 -05:00

25 lines
875 B
Markdown

### Running locally with Docker
Prerequisites: Docker and Docker Compose.
1. Build and start the full stack (Postgres, Redis, Web):
```
docker compose up --build
```
2. Configure BigQuery credentials via environment variables (e.g., export `GOOGLE_PROJECT_ID` and `GOOGLE_APPLICATION_CREDENTIALS_JSON`). For local compose, you can add them under the `web.environment` section in `docker-compose.yml`.
3. The app runs on `http://localhost:3000`.
Environment variables of interest:
- `DATABASE_URL`: Postgres connection string.
- `REDIS_URL`: Redis URL.
- `ENABLE_CRON`: Set to `true` to run the daily ETL.
- `CRON_SCHEDULE`: Cron string (default 2 AM UTC daily).
- `GOOGLE_PROJECT_ID`, `GOOGLE_APPLICATION_CREDENTIALS_JSON` or `GOOGLE_APPLICATION_CREDENTIALS` for BigQuery.
The container entrypoint waits for Postgres, applies Prisma migrations, then starts the app.