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
Application
.magento.app.yaml
Defines how to build and deploy Adobe Commerce, including services, hooks, and cron jobs.
Environment
.magento.env.yaml
Centralizes the management of build and deploy actions across all of your environments, including Pro Staging and Production, using environment variables.
Routes
.magento/routes.yaml
Configure caching, redirects, and server-side includes.
Service
.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 settings
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 and disk 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.
recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26