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:
-
On your local workstation, change to your project directory.
-
Use SSH to log in to the remote environment.
magento-cloud ssh
-
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
-
-
Uninstall the Adobe Commerce application.
php bin/magento setup:uninstall -n
-
Confirm that Adobe Commerce was successfully uninstalled.
The following message displays to confirm a successful uninstallation:
[SUCCESS]: Magento uninstallation complete.
-
Clear the
var/
subdirectories.rm -rf var/*
-
Log out.
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:
-
On your local workstation, change to your project directory.
-
Use SSH to log in to the remote environment.
magento-cloud ssh
-
Connect to the database.
mysql -h database.internal
-
Drop the
main
database.drop database main;
-
Create an empty
main
database.create database main;
-
Delete the following configuration files.
config.php
config.php.bak
env.php
env.php.bak
-
Log out and trigger a redeployment.
magento-cloud environment:redeploy