Uninstall Commerce

Uninstalling the Commerce application returns your environment to an original state by restoring the database, removing the deployment configuration, and clearing the var/ subdirectories. This guidance also resets your git branch to an earlier stable state. If you do not have a recent backup, but you can access the remote environment using SSH, follow these steps to restore your environment:

  • Disable configuration management
  • Uninstall Adobe Commerce
  • Reset the git branch

Uninstalling the Adobe Commerce software drops and restores the database, removes the deployment configuration, and clears the var/ subdirectories. It is important to disable Configuration management so that it does not automatically apply the previous configuration settings during the next deployment. Make sure that your app/etc/ directory does not contain the config.php file.

To uninstall the Adobe Commerce software:

  1. On your local workstation, change to your project directory.

  2. Use SSH to log in to the remote environment.

    magento-cloud ssh
    
  3. Remove the configuration file.

    • For Adobe Commerce 2.2 and later:

      rm app/etc/config.php
      
    • For Adobe Commerce 2.1:

      rm app/etc/config.local.php
      
  4. Uninstall the Adobe Commerce application.

    php bin/magento setup:uninstall -n
    
  5. Confirm that Adobe Commerce was successfully uninstalled.

    The following message displays to confirm a successful uninstallation:

    [SUCCESS]: Magento uninstallation complete.
    
  6. Clear the var/ subdirectories.

    rm -rf var/*
    
  7. Log out.

TIP
Optionally, it is a good practice to clean build caches.
magento-cloud project:clear-build-cache

Force a redeployment

If you have attempted to uninstall Adobe Commerce and your deployment continues to fail, you can try to manually force a redeployment.

git commit --allow-empty -m "<message>" && git push <origin> <branch>

Reset the database

If you have attempted to uninstall Adobe Commerce and the command failed or could not complete, you can manually reset the database.

To reset the database:

  1. On your local workstation, change to your project directory.

  2. Use SSH to log in to the remote environment.

    magento-cloud ssh
    
  3. Connect to the database.

    mysql -h database.internal
    
  4. Drop the main database.

    drop database main;
    
  5. Create an empty main database.

    create database main;
    
  6. Delete the following configuration files.

    • config.php
    • config.php.bak
    • env.php
    • env.php.bak
  7. Log out and trigger a redeployment.

    magento-cloud environment:redeploy
    
WARNING
The deployment process begins when you perform a merge, push, or synchronization of your environment, or when you trigger a manual redeployment, during which the Commerce application is in maintenance mode. For a Production environment, Adobe recommends completing this work during off-peak hours to avoid service disruptions.
Previous pageProtective block
Next pageManage disk space

Commerce