Skip to content

Additional Service Configurations & Add-ons

DDEV projects can be extended using add-ons or custom Docker Compose services.

Add-ons are pre-packaged extensions that provide services with automatic installation and configuration.

See Using Add-ons for:

  • Installing add-ons with ddev add-on get
  • Managing and customizing add-ons
  • Official add-on catalog

See Creating Add-ons for:

  • Building your own add-ons
  • Using PHP or Bash actions
  • Publishing and sharing add-ons

Custom Docker Compose Services

For specialized needs or deep customization, you can create custom services using docker-compose.*.yaml files.

See Custom Docker Compose Services for:

  • Deciding when a custom service makes more sense than an add-on
  • The x-ddev extension field and a gallery of worked examples
  • Converting services to add-ons

See Defining Additional Services with Docker Compose for:

  • How DDEV merges docker-compose.*.yaml files
  • Required conventions: labels, container naming, the build:/-built tag pattern, port exposure

Resources