How to Install a Custom Version of Magento

Magento is one of the most powerful and popular e-commerce systems in the world. Softaculous Apps Installer allows you to install the latest version in just a few clicks.

Still, it may be necessary to use functionality that only presents in an older version. These versions should be installed manually.

In this guide, we will walk through the installation of Magento 2.1.12 via cPanel interface and command line/composer.

Preparing files and database


1. First, make sure that shell access (SSH) is enabled for your account. You can review and enable it in cPanel >> Manage Shell menu.

More details on how to enable SSH via cPanel can be found in this article.

2. The next step is to access the server via SSH. You can do this either with PuTTy or by using Terminal.

3. Navigate to the root folder of the site (in this example,


4. Confirm that Composer is installed by running the following commands:
  • which composer
  • composer --help

If you see no output, refer to the installation steps here.

Preparing files and database

1. To begin, you need to find the Magento version you need. The main repositories for older versions are:
For this example, we will use Github.

2. In order to download the archive, you must run the wget command along with the direct link to the file archive. In this case, it’s:
  • wget

(Make sure to replace the URL with the one you need.)

3. Use the following command to extract the files:
  • tar xfz 2.1.12.tar.gz --strip 1

Remember to replace the 2.1.12.tar.gz with the name of the archive in question. Also, remember to use the --strip 1 option, or you will have to move the files manually.

4. To install Magento via Composer, use the composer install command.

Wait for the process to complete. You will see the "Generation Autoload Files" message when it finishes:

5. The next step is the database setup. For this step, you will need to do the following:
  • Create the database.
  • Create a user and set a password.
  • Add the user to the database.
Detailed steps for this can be found here.


1. You must open your website in a browser in order to continue the installation process. You will then be asked to accept Magento’s User Agreement:

2. Next, a system readiness check will be performed:

In case any of the PHP requirements are not met, please refer to the tutorial on how to adjust your PHP settings. File permissions can be reviewed and changed as described here.

3. Once the check is completed, enter the details for the database you created earlier (see Step 5 above):
  • Database Server Host (localhost)
  • Database Server Username (username of the user assigned to the database)
  • Database Server Password (password of the user assigned to the database)
  • Database Name

4. The next step (Web Configuration) allows you to perform the basic configuration of the website and admin panel. These settings are entirely based on your preference.

5. Finally, press Install Now to complete the installation.

You should see this message:

That’s it! You have installed a custom version of Magento.
11156 times

Need help? We're always here for you.