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.