Docker development

Magento Cloud Docker provides an option to deploy Magento Commerce to a Docker environment for development, test, and automation tasks.

The Magento Commerce Cloud Docker environment requires three, essential components: a Magento Commerce v2 template, Docker Compose, and the Magento Commerce Cloud ece-tools package.

See Configure Docker for additional information about Docker prerequisites and using the Magento Cloud Docker environment.

Host Operating Systems

The Cloud Docker environment supports Linux, macOS, and Windows operating systems. The containers should run on any Docker host, but some of the set up scripts require you to install PHP and Composer.

Gather credentials

Prior to setting up a local workspace, gather the following credentials and accounts:

  • Magento authentication keys (Composer keys)

    Magento authentication keys are 32-character authentication tokens that provide secure access to the Magento 2 Composer repository (, and any other Git services required for Magento development such as GitHub. Your account can have multiple Magento authentication keys. For the workspace setup, start with one specific key for your code repository. If you do not have any keys, contact the Account Owner to create them, or create the Magento authentication keys yourself.

  • Cloud Project account

    The License Owner or Technical Admin (Super User) should invite you to the Magento Commerce Cloud project. When you receive the e-mail invitation, click the link and follow the prompts to create your account. See Set up an account for details.

  • Magento Encryption Key

    When importing an existing Magento system only, capture the Magento encryption key used to protect your access and data for the Magento database. For details on this key, see Resolve issues with encryption key.

Launch a Docker environment

You can use the Docker environment to emulate the Magento Commerce Cloud Integration and production environments for local development and testing. You need three, essential components: a Magento Commerce v2 template, Docker Compose, and Magento Commerce Cloud ece-tools package.

Getting support for Magento Cloud Docker

Magento Cloud Docker is a Magento Community Engineering project supported by the Magento developer community. You have several options to get support and learn more about Magento Cloud Docker and Magento local development.