Skip to main content

Docker Compose Profiles

Local infrastructure uses Docker Compose profiles so developers can start only the services needed for a task.

Operating Rules

  • Use the profile documented for the service under test.
  • Keep local .env files out of git.
  • Prefer pnpm exec inside scripts or Docker-related commands when invoking workspace tools.
  • Do not assume local ports match production routing.

Troubleshooting

If a service does not start, check profile selection, missing variables, volume state, and port conflicts before changing application code.

Related pages: Monorepo and Environment Variables.