Restore configuration files

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

If you encounter problems resulting from a missing or altered configuration file, 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.

   1
   ./vendor/bin/ece-tools backup:list
   

   1
   2
   3
   The list of backup files:
   app/etc/env.php
   app/etc/config.php
   

3. Restore the configuration files.

   1
   ./vendor/bin/ece-tools backup:restore
   

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

   1
   2
   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.

   1
   ./vendor/bin/ece-tools backup:restore --force
   

   1
   2
   3
   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.

   1
   ./vendor/bin/ece-tools backup:restore --force --file=app/etc/config.php
   

   1
   2
   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.