Error messages for ECE-Tools

This error message reference provides information to troubleshoot errors that can occur during the Adobe Commerce on cloud infrastructure build, deploy, and post-deploy processes.

All critical and warning error messages that occur during deployment are written to both the var/log/cloud.log and /var/log/cloud.error.log files. The cloud error log file contains only errors from the latest deployment. An empty file indicates a successful deployment with no errors.

In the cloud.error.log file, each entry is formatted as a JSON string for easier parsing:

{"errorCode":1006,"stage":"build","step":"validate-config","suggestion":"No stores/website/locales found in config.php\n  To speed up the deploy process do the following:\n  1. Using SSH, log in to your Magento Cloud account\n  2. Run \"php ./vendor/bin/ece-tools config:dump\"\n  3. Using SCP, copy the app/etc/config.php file to your local repository\n  4. Add, commit, and push your changes to the app/etc/config.php file","title":"The configured state is not ideal","type":"warning"}

Error messages are categorized by one of the deployment stages: build, deploy, and post-deploy. Each section provides a list of associated errors with the following information for each error:

  • Error code: The Adobe Commerce-assigned identifier for the error message
  • Stage: Indicates whether the error occurred during the build, deploy, or post-deploy stage
  • Step: Indicates the step in the deployment scenario that can return the error. If the Step column is blank, the error is a general error that can be returned by multiple steps, or during pre-processing operations. See Scenario-based deployment for more information about the build, deploy, and post-deploy steps.
  • Suggestion: Provides guidance to troubleshoot and resolve the error
  • Title (Error description): A description that summarizes the cause of the error
  • Type: Indicates whether the error is a critical error or a warning

Critical Errors

Critical errors indicate a problem with the Adobe Commerce on cloud infrastructure project configuration that causes deployment failure, for example incorrect, unsupported, or missing configuration for required settings. Before you can deploy, you must update the configuration to resolve these errors.

Build stage

Error code Build step Error description (Title) Suggested action
2 Cannot write to the ./app/etc/env.php file Deployment script cannot make required changes to the /app/etc/env.php file. Check your filesystem permissions.
3 Configuration isn’t defined in the schema.yaml file Configuration is not defined in the ./vendor/magento/ece-tools/config/schema.yaml file. Check that the config variable name is correct, and that it is defined.
4 Failed to parse the .magento.env.yaml file The ./.magento.env.yaml file format is invalid. Use a YAML parser to check the syntax and fix any errors.
5 Unable to read the .magento.env.yaml file Unable to read the ./.magento.env.yaml file. Check file permissions.
6 Unable to read the .schema.yaml file Unable to read the ./vendor/magento/ece-tools/config/magento.env.yaml file. Check file permissions and redeploy (magento-cloud environment:redeploy).
7 refresh-modules Cannot write to the ./app/etc/config.php file The deployment script cannot make required changes to the /app/etc/config.php file. Check your filesystem permissions.
8 validate-config Cannot read the composer.json file Unable to read the ./composer.json file. Check file permissions.
9 validate-config Composer.json is missing required autoload section Required autoload section is missing from the composer.json file. Compare the autoload section to the composer.json file in the Cloud template, and add the missing configuration.
10 validate-config The file .magento.env.yaml contains an option that is not declared in the schema, or an option configured with an invalid value or stage The ./.magento.env.yaml file contains invalid configuration. Check the error log for detailed info.
11 refresh-modules Command failed: /bin/magento module:enable --all Try to run composer update locally. Then, commit and push the updated composer.lock file. Also check the cloud.log for more information. For more detailed command output, add the VERBOSE_COMMANDS: '-vvv' option to the .magento.env.yaml file.
12 apply-patches Failed to apply patch
13 set-report-dir-nesting-level Cannot write to the file /pub/errors/local.xml
14 copy-sample-data Failed to copy sample data files
15 compile-di Command failed: /bin/magento setup:di:compile Check the cloud.log for more information. Add VERBOSE_COMMANDS: '-vvv' into .magento.env.yaml for more detailed command output.
16 dump-autoload Command failed: composer dump-autoload The composer dump-autoload command failed. Check the cloud.log for more information.
17 run-baler The command to run Baler for JavaScript bundling failed Check the SCD_USE_BALER environment variable to verify that the Baler module is configured and enabled for JS bundling. If you do not need the Baler module, set SCD_USE_BALER: false.
18 compress-static-content Required utility wasn’t found (timeout, bash)
19 deploy-static-content Command /bin/magento setup:static-content:deploy failed Check the cloud.log for more information. For more detailed command output, add the VERBOSE_COMMANDS: '-vvv' option to the .magento.env.yaml file.
20 compress-static-content Static content compression failed Check the cloud.log for more information.
21 backup-data: static-content Failed to copy static content into the init directory Check the cloud.log for more information.
22 backup-data: writable-dirs Failed to copy some writable directories into the init directory Failed to copy writable directories into the ./init folder. Check your filesystem permissions.
23 Unable to create a logger object
24 backup-data: static-content Failed to clean the ./init/pub/static/ directory Failed to clean ./init/pub/static folder. Check your filesystem permissions.
25 Cannot find the Composer package If you installed the Adobe Commerce application version directly from the GitHub repository, verify that the DEPLOYED_MAGENTO_VERSION_FROM_GIT environment variable is configured.
26 validate-config Remove Magento Braintree module configuration which is no longer supported in Adobe Commerce and Magento Open Source 2.4 and later versions. Support for the Braintree module is no longer included with Commerce 2.4.0 and later. Remove the CONFIG__STORES__DEFAULT__PAYMENT__BRAINTREE__CHANNEL variable from the variables section of the .magento.app.yaml file. For Braintree payment support, use an official extension from the Commerce Marketplace instead.

Deploy stage

Error code Deploy step Error description (Title) Suggested action
101 pre-deploy: cache Incorrect cache configuration (missing port or host) Cache configuration is missing required parameters server or port. Check the cloud.log for more information.
102 Cannot write to the ./app/etc/env.php file Deployment script cannot make required changes to the /app/etc/env.php file. Check your filesystem permissions.
103 Configuration isn’t defined in the schema.yaml file Configuration is not defined in the ./vendor/magento/ece-tools/config/schema.yaml file. Check that the config variable name is correct, and that it is defined.
104 Failed to parse the .magento.env.yaml file Configuration is not defined in the ./vendor/magento/ece-tools/config/schema.yaml file. Check that the config variable name is correct, and that it is defined.
105 Unable to read the .magento.env.yaml file Unable to read the ./.magento.env.yaml file. Check file permissions.
106 Unable to read the .schema.yaml file
107 pre-deploy: clean-redis-cache Failed to clean the Redis cache Failed to clean the Redis cache. Check that the Redis cache configuration is correct and that the Redis service is available. See Setup Redis service.
108 pre-deploy: set-production-mode Command /bin/magento maintenance:enable failed Check the cloud.log for more information. For more detailed command output, add the VERBOSE_COMMANDS: '-vvv' option to the .magento.env.yaml file.
109 validate-config Incorrect database configuration Check that the DATABASE_CONFIGURATION environment variable is configured correctly.
110 validate-config Incorrect session configuration Check that the SESSION_CONFIGURATION environment variable is configured correctly. The configuration must contain at least the save parameter.
111 validate-config Incorrect search configuration Check that the SEARCH_CONFIGURATION environment variable is configured correctly. The configuration must contain at least the engine parameter.
112 validate-config Incorrect resource configuration Check that the RESOURCE_CONFIGURATION environment variable is configured correctly. The configuration must contain at least connection parameter.
113 validate-config:elasticsuite-integrity ElasticSuite is installed, but the ElasticSearch service is not available Check that the SEARCH_CONFIGURATION environment variable is configured correctly, and verify that the Elasticsearch service is available.
114 validate-config:elasticsuite-integrity ElasticSuite is installed, but another search engine is used ElasticSuite is installed, but another search engine is configured. Update the SEARCH_CONFIGURATION environment variable to enable Elasticsearch, and verify the Elasticsearch service configuration in the services.yaml file.
115 Database query execution failed
116 install-update: setup Command /bin/magento setup:install failed Check the cloud.log and install_upgrade.log for more information. For more detailed command output, add the VERBOSE_COMMANDS: '-vvv' option to the .magento.env.yaml file.
117 install-update: config-import Command app:config:import failed Check the cloud.log for more information. For more detailed command output, add the VERBOSE_COMMANDS: '-vvv' option to the .magento.env.yaml file.
118 Required utility wasn’t found (timeout, bash)
119 install-update: deploy-static-content Command /bin/magento setup:static-content:deploy failed Check the cloud.log for more information. For more detailed command output, add the VERBOSE_COMMANDS: '-vvv' option to the .magento.env.yaml file.
120 compress-static-content Static content compression failed Check the cloud.log for more information.
121 deploy-static-content:generate Cannot update the deployed version Cannot update the ./pub/static/deployed_version.txt file. Check your filesystem permissions.
122 clean-static-content Failed to clean static content files
123 install-update: split-db Command /bin/magento setup:db-schema:split failed Check the cloud.log for more information. For more detailed command output, add the VERBOSE_COMMANDS: '-vvv' option to the .magento.env.yaml file.
124 clean-view-preprocessed Failed to clean the var/view_preprocessed folder Unable to clean the ./var/view_preprocessed folder. Check your filesystem permissions.
125 install-update: reset-password Failed to update the /var/credentials_email.txt file Failed to update the /var/credentials_email.txt file. Check your filesystem permissions.
126 install-update: update Command /bin/magento setup:upgrade failed Check the cloud.log and install_upgrade.log for more information. For more detailed command output, add the VERBOSE_COMMANDS: '-vvv' option to the .magento.env.yaml file.
127 clean-cache Command /bin/magento cache:flush failed Check the cloud.log for more information. For more detailed command output, add the VERBOSE_COMMANDS: '-vvv' option to the .magento.env.yaml file.
128 disable-maintenance-mode Command /bin/magento maintenance:disable failed Check the cloud.log for more information. Add VERBOSE_COMMANDS: '-vvv' into .magento.env.yaml for more detailed command output.
129 install-update: reset-password Unable to read reset password template
130 install-update: cache_type Command failed: php ./bin/magento cache:enable Command php ./bin/magento cache:enable runs only when Adobe Commerce was installed but ./app/etc/env.php file was absent or empty at the beginning of the deployment. Check the cloud.log for more information. Add VERBOSE_COMMANDS: '-vvv' into .magento.env.yaml for more detailed command output.
131 install-update The crypt/key key value does not exist in the ./app/etc/env.php file or the CRYPT_KEY cloud environment variable This error occurs if the ./app/etc/env.php file is not present when Adobe Commerce deployment begins, or if the crypt/key value is undefined. If you migrated the database from another environment, retrieve the crypt key value from that environment. Then, add the value to the CRYPT_KEY cloud environment variable in your current environment. See Add the Magento encryption key. If you accidentally removed the ./app/etc/env.php file, use the following command to restore it from the backup files created from a previous deployment: ./vendor/bin/ece-tools backup:restore CLI command."
132 Can not connect to the Elasticsearch service Check for valid Elasticsearch credentials and verify that the service is running
137 Can not connect to the OpenSearch service Check for valid OpenSearch credentials and verify that the service is running
133 validate-config Remove Magento Braintree module configuration which is no longer supported in Adobe Commerce or Magento Open Source 2.4 and later versions. Support for the Braintree module is no longer included with Adobe Commerce or Magento Open Source 2.4.0 and later. Remove the CONFIG__STORES__DEFAULT__PAYMENT__BRAINTREE__CHANNEL variable from the variables section of the .magento.app.yaml file. For Braintree support, use an official Braintree Payments extension from the Commerce Marketplace instead.
134 validate-config Adobe Commerce and Magento Open Source 2.4.0 require Elasticsearch service to be installed Install Elasticsearch service
138 validate-config Adobe Commerce and Magento Open Source 2.4.4 requires OpenSearch or Elasticsearch service to be installed Install OpenSearch service
135 validate-config The search engine must be set to Elasticsearch for Adobe Commerce and Magento Open Source >= 2.4.0 Check the SEARCH_CONFIGURATION variable for the engine option. If it is configured, remove the option, or set the value to “elasticsearch”.
136 validate-config Split Database was removed starting from Adobe Commerce and Magento Open Source 2.5.0. If you use split database that you have to revert to or migrate to a single database or use an alternative approach.
139 validate-config Incorrect search engine This Adobe Commerce or Magento Open Source version does not support OpenSearch. You must use versions 2.3.7-p3, 2.4.3-p2, or higher

Post-deploy stage

Error code Post-deploy step Error description (Title) Suggested action
201 is-deploy-failed Deploy stage failed
202 The ./app/etc/env.php file is not writable Deployment script cannot make required changes to the /app/etc/env.php file. Check your filesystem permissions.
203 Configuration isn’t defined in the schema.yaml file Configuration is not defined in the ./vendor/magento/ece-tools/config/schema.yaml file. Check that the config variable name is correct, and that it is defined.
204 Failed to parse the .magento.env.yaml file The ./.magento.env.yaml file format is invalid. Use a YAML parser to check the syntax and fix any errors.
205 Unable to read the .magento.env.yaml file Check file permissions.
206 Unable to read the .schema.yaml file
207 warm-up Failed to warm-up some pages
208 time-to-firs-byte Failed to test time to first byte (TTFB)
227 clean-cache Command /bin/magento cache:flush failed Check the cloud.log for more information. Add VERBOSE_COMMANDS: '-vvv' into .magento.env.yaml for more detailed command output.

General

Error code General step Error description (Title) Suggested action
243 Configuration is not defined in the schema.yaml file Check that the config variable name is correct, and that it defined.
244 Failed to parse the .magento.env.yaml file The ./.magento.env.yaml file format is invalid. Use a YAML parser to check the syntax and fix any errors.
245 Unable to read the .magento.env.yaml file Unable to read the ./.magento.env.yaml file. Check file permissions.
246 Unable to read the .schema.yaml file
247 Unable to generate a module for eventing Check the cloud.log for more information.
248 Unable to enable a module for eventing Check the cloud.log for more information.

Warning Errors

Warning errors indicate a problem with the Commerce on cloud infrastructure project configuration such as incorrect, deprecated, unsupported, or missing configuration settings for optional features that can affect site operation. Although a warning does not cause deployment failure, you should review warning messages and update the configuration to resolve them.

Build stage

Error code Build step Error description (Title) Suggested action
1001 validate-config File app/etc/config.php does not exist
1002 validate-config The ./build_options.ini file is no longer supported
1003 validate-config The modules section is missing from the shared config file
1004 validate-config The configuration is not compatible with this version of Commerce
1005 validate-config SCD options ignored
1006 validate-config The configured state is not ideal
1007 run-baler Baler JS bundling cannot be used

Deploy stage

Error code Deploy step Error description (Title) Suggested action
2001 pre-deploy:cache Cache is configured for a Redis service that is not available. Configuration is ignored.
2002 validate-config The configured state is not ideal
2003 validate-config The directory nesting level value for error reporting has not been configured
2004 validate-config Invalid configuration in the ./pub/errors/local.xml file.
2005 validate-config Admin data is used to create an admin user during initial installation only. Any changes to Admin data are ignored during the upgrade process. After the initial installation, you can remove admin data from the configuration.
2006 validate-config Admin user was not created as admin email was not set After installation, you can create an admin user manually: Use ssh to connect to your environment. Then, run the bin/magento admin:user:create command.
2007 validate-config Update php version to recommended version
2008 validate-config Solr support has been deprecated in Adobe Commerce and Magento Open Source 2.1.
2009 validate-config Solr is no longer supported by Adobe Commerce and Magento Open Source 2.2 or later.
2010 validate-config Elasticsearch service is installed at infrastructure layer, but it is not used as a search engine. Consider removing the Elasticsearch service from the infrastructure layer to optimize resource usage.
2011 validate-config Elasticsearch service version on infrastructure layer is not compatible with current version of the elasticsearch/elasticsearch module, used by your Adobe Commerce application.
2012 validate-config The current configuration is not compatible with this version of Adobe Commerce
2013 validate-config SCD options ignored because the deploy process did not run on the build phase
2014 validate-config The configuration contains deprecated variables or values
2015 validate-config Environment configuration is not valid
2016 validate-config JSON type configuration can not be decoded
2017 validate-config The current configuration is not compatible with this version of Adobe Commerce
2018 validate-config Some services have passed EOL
2019 validate-config The MySQL search configuration option is deprecated Use Elasticsearch instead.
2029 validate-config Split Database was deprecated in the Adobe Commerce and Magento Open Source 2.4.2 and will be removed in 2.5. If you use split database that you should start planning to revert to or migrate to a single database or use an alternative approach.
2020 install-update Adobe Commerce installation completed, but the app/etc/env.php configuration file was missing or empty. Required data is restored from environment configurations and from .magento.env.yaml file.
2021 install-update:db-connection For split databases used custom connections
2022 install-update:db-connection You have changed to a database configuration that is not compatible with the slave connection.
2023 install-update:split-db Enabling a split database will be skipped.
2024 install-update:split-db The SPLIT_DB variable is missing the configuration for split connection types.
2025 install-update:split-db Slave connection not set.
2026 pre-deploy:restore-writable-dirs Failed to restore some data generated during the build phase to the mounted directories Check the cloud.log for more information.
2027 validate-config:mage-mode-variable Mode value for MAGE_MODE environment variable not supported Remove the MAGE_MODE environment variable, or change its value to “production”. Adobe Commerce on cloud infrastructure supports “production” mode only.
2028 remote-storage Remote storage could not be enabled. Verify remote storage credentials.
2030 validate-config Elasticsearch and OpenSearch services are both installed at infrastructure layer. Adobe Commerce and Magento Open Source 2.4.4 and higher use OpenSearch by default Consider removing the Elasticsearch or OpenSearch service from the infrastructure layer to optimize resource usage.

Post-deploy stage

Error code Post-deploy step Error description (Title) Suggested action
3001 validate-config Debug logging is enabled in Adobe Commerce To save disk space, do not enable debug logging for your production environments.
3002 warm-up Can not fetch store urls
3003 warm-up Can not fetch store url
3004 backup Cannot create backup files

General

Error code General step Error description (Title) Suggested action
4001 Can not get system processor count:

On this page