Configuration files overview
Environments in Adobe Commerce on cloud infrastructure include containers with applications, services, and a database to provide a complete system for your Adobe Commerce application codebase and files.
You can configure application settings, routes, build and deploy actions, and notifications to support your project environments using the following configuration files:
Configuration
Filename
Description
.magento.app.yaml
Defines how to build and deploy Adobe Commerce, including services, hooks, and cron jobs.
.magento.env.yaml
Centralizes the management of build and deploy actions across all of your environments, including Pro Staging and Production, using environment variables.
.magento/services.yaml
Defines the services Adobe Commerce uses by name and version. For example, this file may include versions of MariaDB, PHP extensions, Redis, RabbitMQ, and Elasticsearch or OpenSearch. You must open a support ticket to push these changes to Pro plan Staging and Production environments.
php.ini
An optional file that can be added to the project. The settings contained in this file are appended to the ones maintained by the cloud infrastructure.
Configuration updates to Pro environments
For Adobe Commerce on cloud infrastructure Pro Staging and Production environments, you can update many configuration options in your local development environment and commit the changes to apply them to these environments. However, you must Submit an Adobe Commerce Support ticket to update the following configuration options:
- Install or update services in the
.magento/services.yaml
file. - Change the configuration for the
mounts
anddisk
properties in the.magento.app.yaml
file.
WARNING
Some Pro projects require a support ticket to update the route configuration in the
routes.yaml
file and the cron configuration in the .magento.app.yaml
file. Adobe recommends updating and testing YAML configuration files in an Integration environment, then deploying changes to the Staging environment. If your changes are not applied to Staging sites after you redeploy and there are no related error messages in the log, then you MUST Submit an Adobe Commerce Support ticket that describes the attempted configuration changes. Include any updated YAML configuration files in the ticket.05f2f56e-ac5d-4931-8cdb-764e60e16f26