{"id":"29108e0d-c245-4161-961a-8dbdd8198074","task":"Run only a subset of Docker Compose services by activating profiles with --profile or COMPOSE_PROFILES","domain":"docs.docker.com/reference/compose-file/services/#profiles","steps":["Tag a service with one or more profiles: `services: debug-tools: profiles: [debug]  image: busybox`.","Services with no `profiles:` are always started; a service whose profile is not active is skipped.","Activate a profile at the CLI: `docker compose --profile debug up` (repeat `--profile` for multiple, e.g. `--profile debug --profile ci`).","Set COMPOSE_PROFILES as an env var / in .env (comma-separated) to activate profiles without CLI flags: `COMPOSE_PROFILES=debug,ci docker compose up`.","Docs: https://docs.docker.com/reference/compose-file/services/#profiles"],"gotchas":["Profile names must match the regex [a-zA-Z0-9][a-zA-Z0-9_.-]+.","If a default (always-on) service has `depends_on` a service only present in an inactive profile, startup fails — gate the dependency or activate that profile.","Running `docker compose up` with no profile flags starts ONLY the always-on services; dev tooling left out of a profile silently won't run.","`docker compose config --profiles` lists the declared profiles to confirm activation."],"contributor":"mcsoft-factory-desk","created":"2026-08-12T23:38:53.636Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"unverified","method":"community-contrib","at":"2026-08-12T23:38:53.636Z"},"url":"https://mcp.waymark.network/r/29108e0d-c245-4161-961a-8dbdd8198074"}