DocumentationCommerceInstallation Guide

Uninstall modules

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • Experienced
  • Admin
  • Developer

This section discusses how to uninstall one or more modules. During uninstallation, you can optionally remove the modules’ code, database schema, and database data. You can create backups first so you can recover the data later.

You should uninstall a module only if you’re certain you won’t use it. Instead of uninstalling a module, you can disable it as discussed in Enable or disable modules.

NOTE
This command checks that only dependencies declared in the composer.json file. If you uninstall a module that is not defined in the composer.json file, this command uninstalls the module without checking for dependencies. This command does not, however, remove the module’s code from the file system. You must use file system tools to remove the module’s code (for example, rm -rf <path to module>). As an alternative, you can disable non-Composer modules.

Command usage:

bin/magento module:uninstall [--backup-code] [--backup-media] [--backup-db] [-r|--remove-data] [-c|--clear-static-content] \
  {ModuleName} ... {ModuleName}

Where {ModuleName} specifies the module name in <VendorName>_<ModuleName> format. For example, the Customer module name is Magento_Customer. To get a list of module names, enter magento module:status

The module uninstall command performs the following tasks:

  1. Verifies that the specified modules exist in the code base and are packages installed by Composer.

    This command works only with modules defined as Composer packages.

  2. Checks for dependencies with other modules and terminates the command if there are any unmet dependencies.

    To work around this, you can either uninstall all modules at the same time or you can uninstall the dependent modules first.

  3. Requests confirmation to proceed.

  4. Puts the store in maintenance mode.

  5. Processes the following command options.

    table 0-row-3 1-row-3 2-row-3 3-row-3
    Option Meaning Backup file name and location
    --backup-code Backs up the file system (excluding var and pub/static directories). var/backups/<timestamp>_filesystem.tgz
    --backup-media Backs up the pub/media directory. var/backups/<timestamp>_filesystem_media.tgz
    --backup-db Backs up the database. var/backups/<timestamp>_db.gz

  6. If --remove-data is specified, remove the database schema and data defined in the module’s Uninstall classes.

    For each specified module to uninstall, invokes the uninstall method in its Uninstall class. This class must inherit from Magento\Framework\Setup\UninstallInterface.

  7. Removes the specified modules from the setup_module database table.

  8. Removes the specified modules from the module list in the deployment configuration.

  9. Removes code from the codebase using composer remove.

    note note
    NOTE
    Uninstalling a module always runs composer remove. The --remove-data option removes database data and schema defined by the module’s Uninstall class.

  10. Cleans the cache.

  11. Updates generated classes.

  12. If --clear-static-content is specified, cleans generated static view files.

  13. Takes the store out of maintenance mode.

For example, if you attempt to uninstall a module that another module depends on, the following message displays:

magento module:uninstall Magento_SampleMinimal
    Cannot uninstall module 'Magento_SampleMinimal' because the following module(s) depend on it:
        Magento_SampleModifyContent

One alternative is to uninstall both modules after backing up the module file system, pub/media files, and database tables but not removing the module’s database schema or data:

bin/magento module:uninstall Magento_SampleMinimal Magento_SampleModifyContent --backup-code --backup-media --backup-db

Messages similar to the following display:

You are about to remove code and/or database tables. Are you sure?[y/N]y
Enabling maintenance mode
Code backup is starting...
Code backup filename: 1435261098_filesystem_code.tgz (The archive can be uncompressed with 7-Zip on Windows systems)
Code backup path: /var/www/html/magento2/var/backups/1435261098_filesystem_code.tgz
[SUCCESS]: Code backup completed successfully.
Media backup is starting...
Media backup filename: 1435261098_filesystem_media.tgz (The archive can be uncompressed with 7-Zip on Windows systems)
Media backup path: /var/www/html/magento2/var/backups/1435261098_filesystem_media.tgz
[SUCCESS]: Media backup completed successfully.
DB backup is starting...
DB backup filename: 1435261098_db.gz (The archive can be uncompressed with 7-Zip on Windows systems)
DB backup path: /var/www/html/magento2/var/backups/1435261098_db.gz
[SUCCESS]: DB backup completed successfully.
You are about to remove a module(s) that might have database data. Remove the database data manually after uninstalling, if desired.
Removing Magento_SampleMinimal, Magento_SampleModifyContent from module registry in database
Removing Magento_SampleMinimal, Magento_SampleModifyContent from module list in deployment configuration
Removing code from Magento codebase:
Loading composer repositories with package information
Updating dependencies (including require-dev)
  - Removing magento/sample-module-modifycontent (1.0.0)
Removing Magento/SampleModifycontent
  - Removing magento/sample-module-minimal (1.0.0)
Removing Magento/SampleMinimal
Writing lock file
Generating autoload files
Cache cleared successfully.
Generated classes cleared successfully.
Alert: Generated static view files were not cleared. You can clear them using the --clear-static-content option. Failure to clear static view files might cause display issues in the Admin and storefront.
Disabling maintenance mode
NOTE
Errors display if you attempt to uninstall a module with a dependency on another module. In that case, you cannot uninstall one module; you must uninstall both.

Roll back the file system, database, or media files

To restore the codebase to the state at which you backed it up, use the following command:

bin/magento setup:rollback [-c|--code-file="<filename>"] [-m|--media-file="<filename>"] [-d|--db-file="<filename>"]

Where <filename> is the name of the backup file in the <app_root>/var/backups directory. To display a list of backup files, enter magento info:backups:list

WARNING
This command deletes the specified files or the database before restoring them. For example, the --media-file option deletes media assets under the pub/media directory before restoring from the specified rollback file. Make sure you have not changed the file system or database that you want to keep before using this command.
NOTE
To display a list of available backup files, enter magento info:backups:list

This command performs the following tasks:

  1. Puts the store in maintenance mode.

  2. Verifies the backup file name.

  3. If you specify a code rollback file:

    a. Verifies that the rollback destination locations are writable (note that the pub/static and var folders are ignored).

    b. Deletes all files and directories under your application installation directory.

    c. Extracts the archive file to the destination locations.

  4. If you specify a database rollback file:

    a. Drops the entire database.

    b. Restores the database using the database backup.

  5. If you specify a media rollback file:

    a. Verifies that the rollback destination locations are writable.

    b. Deletes all files and directories under pub/media

    c. Extracts the archive file to the destination locations.

  6. Takes the store out of maintenance mode.

For example, to restore a code (that is, file system) backup, enter the following commands in the order shown:

  • Display a list of backups:

    code language-bash 
    magento info:backups:list

  • Restore a file backup named 1433876616_filesystem.tgz:

    code language-bash 
    magento setup:rollback --code-file="1433876616_filesystem.tgz"

    Messages similar to the following display:

    code language-none 
    Enabling maintenance mode
Code rollback is starting ...
Code rollback filename: 1433876616_filesystem.tgz
Code rollback file path: /var/www/html/magento2/var/backups/1433876616_filesystem.tgz
[SUCCESS]: Code rollback has completed successfully.
Disabling maintenance mode
NOTE
To run the magento command again without changing directories, you might need to enter cd pwd.
recommendation-more-help
0f8e7db5-0e9c-4002-a5b8-a0088077d995