How to install an Amasty extension?

How to install an Amasty extension?

There are two ways of installing an extension on Magento 2. It's recommended to use one and the same installation method for all Amasty extensions. 

Composer installation

Step 1. To download and install Magento modules, the vendor repository is required. The Amasty repository can be added with the next command:

composer config repositories.amasty composer <path>

Instead of <path>, indicate the repository for a specific Magento edition: 
https://composer.amasty.com/community - for community extensions.
https://composer.amasty.com/enterprise/ - for enterprise extensions.


Step 2. The customer will be asked for a login (Public Key) and password (Private Key) when trying to install the package from the Amasty Composer repository for the first time. Access keys can be found and generated in the customer account in Products → Access keys:



It is possible to manually save the keys in the repository, so there is no need to get authorized every time. Find the Magento root directory and indicate:

composer config --auth http-basic.composer.amasty.com $COMPOSER_AMASTY_USERNAME $COMPOSER_AMASTY_PASSWORD


Where $COMPOSER_AMASTY_USERNAME is the Public Key and  $COMPOSER_AMASTY_PASSWORD is the Private Key.

Otherwise, when the customer will be asked for access keys for the first time, they need to agree to save the credentials by printing yes.

     
Step 3. To install the module, the following command should be used:

composer require amasty/<module-name>

Here <module-name> is the Composer name of the extension you are installing. To find the Composer name of the module, open the Products tab of your account and find the Composer packages section:


Step 4. Execute the following commands after the extension is installed:

php bin/magento setup:upgrade
php bin/magento setup:di:compile 
php bin/magento setup:static-content:deploy (your locale)
      
For more information about Composer and its options to manage Amasty extensions, refer to our Composer guide. 


Manual file upload

Step 1. Navigate to the Products tab in your customer account. Scroll down to the Packages section and click the Download link for the extension that should be updated:



Step 2. Unpack the downloaded .zip file. 

Step 3. Connect to the server where the website source folder is located with an FTP/SFTP client (WinSCP, Filezilla, Cyberduck, etc).

Step 4. Go to /upload/app and upload the files to the /app folder of your Magento website using the ‘Merge’ upload mode. This way, your FTP/SFTP client will only add new files.



Step 5. Connect to the Magento root directory via SSH and run the following commands: 

php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy



      • Related Articles

      • How to update an Amasty extension?

        Below, you may find the instructions on installing an update to an Amasty extension. Choose the appropriate method of the extension update – via Composer or via manual file upload. The choice of the method corresponds to the initial way the extension ...

      • How to uninstall an extension?

        Preparation Before making any changes to your Magento instance, either live or a dev site, make sure to create backups. This way you can secure the changes in case something goes wrong in the process. So that the uninstall goes smoothly, it's ...

      • I’m trying to install the module via composer, but the package is not found. How to resolve it?

        Composer is the dependency manager that allows you easily download the required files on your server. The files are located on a remote server, or a repository, that you need to add to the list of “known” ones and authenticate to using the username ...

      • How can I check the current version of my Amasty extension?

        Verifying the version of an Amasty extension can be done through multiple methods. Method #1. Magento admin You can easily check the version of an installed extension through the Magento admin panel. For that, navigate to Stores → Configuration → ...

      • I’ve updated the modules via composer and I got the error Amasty/Base has been already defined.

        For Amasty modules, there are two possible ways of installation/update: via composer and via a direct file upload. Depending on the initial installation method, the module files will be located in a specific directory. Each installation method has ...