DocumentationCommerceCommerce KB

Missing or altered configuration file

Last update: Wed Nov 06 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • Developer

This article talks about how to solve the issue where your configuration files got altered or are missing.

Affected products and versions

  • Adobe Commerce on cloud infrastructure, all versions

Issue

Configuration files config.php and/or env.php were changed wrongly or are missing.

Solution

The deployment process creates a backup file for each configuration file:

  • app/etc/config.php.bak — contains system-specific settings and is auto-generated during build if it does not exist
  • app/etc/env.php.bak — contains sensitive configuration data

You can restore them using the ECE-tools backup:restore command.

The BAK files are a product of the deployment process. If you manually change a configuration file after the deployment, your changes are not reflected in the existing BAK files.

To restore the configuration files:

  1. Log in to your remote repository using SSH.

  2. List the available backup files.

    code language-none 
    ./vendor/bin/ece-tools backup:list
    code language-none 
    The list of backup files:
app/etc/env.php
app/etc/config.php

  3. Restore the configuration files.

    code language-none 
    ./vendor/bin/ece-tools backup:restore

    You receive a list of the existing configuration files affected by the restore.

    code language-none 
    app/etc/env.php file exists! If you want to rewrite existed files use --force
app/etc/config.php file exists! If you want to rewrite existed files use --force

  4. Use the --force option to overwrite all files.

    code language-none 
    ./vendor/bin/ece-tools backup:restore --force
    code language-none 
    Command backup:restore with option --force will rewrite your existed files. Do you want to continue [y/N]?y
Backup file app/etc/env.php was restored.
Backup file app/etc/config.php was restored.

  5. Optionally, you can restore a specific configuration file.

    code language-none 
    ./vendor/bin/ece-tools backup:restore --force --file=app/etc/config.php
    code language-none 
    Command backup:restore with option --force will rewrite your existed files. Do you want to continue [y/N]?y
Backup file app/etc/config.php was restored.
recommendation-more-help
8bd06ef0-b3d5-4137-b74e-d7b00485808a