You have the option to launch a Docker environment in developer mode, which provides an active development environment with full, writable file system permissions.
If you choose this option, the Adobe Commerce application works only if the Docker containers have access to the Adobe Commerce application data. You can provide access either by directly mapping the current working directory or by using a file synchronization tool.
File synchronization options
The Cloud Docker for Commerce
docker-build command provides the
--sync-engine <type> option to select the file synchronization behavior when you build the
docker-compose.yml configuration file. You can select from the following options:
||Maps the current working directory to the
||Provides manual control over synchronization. Requires running manual commands. This option provides the best performance for macOs and Windows.|
||Uses Mutagen for file synchronization. When you select Mutagen, you must install Mutagen on your host operating system before you launch Docker in developer mode. Use this option on macOS or Windows hosts.|
||Deprecated in 1.2.3: Uses docker-sync for file synchronization. When you select docker-sync, you must [install docker-sync] on your host operating system before you launch Docker in developer mode. Use this option on macOS or Windows hosts.|
If you do not specify a
--sync-engine option, the Magento Docker build uses the
When you start Docker with the
native file synchronization option, the current working directory maps to the
/app folder in the containers:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 fpm: volumes: - '.:/app' build: volumes: - '.:/app' deploy: volumes: - '.:/app' web: volumes: - '.:/app' cron: volumes: - '.:/app'
On macOS or Windows systems, we recommend using the
manual-native file synchronization options. You can use these options in the
ece-docker build:compose command by adding the option as the value for
--sync-engine. For example:
1 ./vendor/bin/ece-docker build:compose --mode="developer" --sync-engine="mutagen"
For detailed configuration instructions, see launch Docker in developer mode.