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 License Registration tab inside projects (if you don't have any projects yet, please create one following the hints from the page):





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)
      
Notes
In case the Hyvä theme is used, kindly make sure to execute the following commands to regenerate styles after installing the Amasty Hyvä package:

php bin/magento hyva:config:generate -f
cd vendor/hyva-themes/magento2-default-theme/web/tailwind
npm run build-prod

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 ...

      • I’ve updated the modules via composer and I got the Autoload error: Module 'Amasty_Base' has been already defined.

        When installing or updating Amasty modules for Magento, there are two primary methods to choose from: using composer or direct file upload. Depending on the initial installation method, the module files will be located in a specific directory. Each ...

      • How to install an Amasty PWA add-on?

        At the moment Amasty PWA add-ons are installed via yarn. The add-ons could be downloaded from the Products tab in the customer account after the purchase. Before starting the installation process, make sure that the Magento instance meets the ...