Step 2: Extract the .zip Extension File

Extract the .zip extension file into a new folder called extension using:

$ unzip .zip -d /home/magento/extension


Once you finish the extension installation process, you can delete this folder using:



$ rm -R /home/magento/extension


Step 3: Verify and Copy the Magento Extension Files Into the app/code Folder
Verify the extracted component file structure meets Magento’s required “vendor/module-name” format.
Navigate to the Magento project root directory and copy the extension files to the app/code folder using:



$ cp -R /home/magento/extension/* app/code


The app/code directory doesn’t exist in the default Magento filesystem. If this is your first attempt to install a Magento extension manually, create the directory using:



$ mkdir app/code


Step 4: Register the Magento 2 Extension and Check Its Status
Complete the Magento 2 extension installation process by executing:



$ php bin/magento setup:upgrade

$ php bin/magento setup:di:compile

$ php bin/magento setup:static-content:deploy -f



The “setup:upgrade” command registers the Magento 2 extension and updates the Magento database schema and data. The subsequent commands compile Magento code and deploy static view files.
Note: You don’t need to deploy static view files in developer mode unless your extension developer’s documentation mandates it.
Verify the status of the extension:



$ php bin/magento module:status _


If it’s disabled, you can enable it using:



$ php bin/magento module:enable _  --clear-static-content


Step 5: Clear Magento Cache and Disable Maintenance Mode
Clear the Magento cache using:



$ php bin/magento cache:clean

$ php bin/magento cache:flush



Follow Adobe’s guide to set permissions for a production file system. Then, disable maintenance mode using:



$ php bin/magento maintenance:disable


Nice work! You’ve learned how to install a Magento 2 extension using a .zip file.

How To Install a Magento 2 Extension With Composer
Before we show you how to install a Magento 2 extension via Composer, make sure you:

Back up your server.
Set pre-install file permissions.
Enable developer mode.
Put Magento in maintenance mode.

Once you’ve met the above conditions, follow our installation guide.
Step 1: Obtain the Extension’s Composer Name and Version
Log in to your Magento Marketplace account and navigate to [Your name] > My Profile.

Go to Marketplace > My Products and click My Purchases.

Locate the Magento 2 extension you want to install and note its Component Name.
Click on the Versions available dropdown and note the version number to install a specific version.

Step 2: Update the Magento composer.json File
Log in to your Magento server as the file system owner and navigate to the Magento root folder to install the module via Composer.
Update the composer.json file from the command line interface (CLI) using:



$ composer require :


Replace “component-name” and “version” with the values obtained in the previous step. For example:

If prompted to enter access keys, copy and paste your public key as the username and private key as the password.
Wait for Composer to update the Magento project dependencies. In case of errors, address them before proceeding.
Step 3: Register the Extension and Clear Magento Cache
Run the following commands to register the Magento 2 extension, compile code, and deploy static view files:



$ php bin/magento setup:upgrade

$ php bin/magento setup:di:compile


Clear the Magento cache by executing:



$ php bin/magento cache:clean

$ php bin/magento cache:flush



Step 4: Check the Magento 2 Extension Status
Verify the extension status:



$ php bin/magento module:status _


If disabled, enable the extension:



$ php bin/magento module:enable _  --clear-static-content


Step 5: Update File Permissions and Disable Maintenance Mode
Set file permissions for a production file system based on your hosting setup. Then, disable maintenance mode as follows:



$ php bin/magento maintenance:disable


Congratulations! You’ve successfully learned how to install a Magento 2 extension using Composer.
Final Thoughts: How To Install a Magento 2 Extension
Learning how to install a Magento 2 extension is the best way to add and extend Magento store functionality. Since Adobe deprecated the Web Setup Wizard in Magento 2.3.6 and above, you can only install Magento 2 extensions using the methods described above.
No matter which method you choose, make sure you backup your server before you begin and set production file permissions after you’re done.
If that seems too much work, sign up for managed Magento hosting with Nexcess and enjoy the convenience of automatic nightly backups and a secure Magento 2 hosting environment.
Browse our plans to learn more.