Skip to content
masterclass Buddy
Start learning

Docker · Option

profiles

Docker Compose profiles turn optional services on or off for different uses. Services without profiles always run; profiled services run when their profile is enabled or they are explicitly targeted.

Last updated

Syntax

services:
  service_name:
    profiles: [profile_name]

docker compose --profile PROFILE up
COMPOSE_PROFILES=PROFILE docker compose up

In-depth API docs are only for subscribers: parameters, examples, common mistakes and interview practice.

Subscribe
  • profiles attribute
  • COMPOSE_PROFILES
  • depends_on
  • docker compose up
  • docker compose down
  • docker compose run

Source: Using profiles with Compose. Checked 2026-11-03.