Title: How To Setup and Configure Latest Magento 2.x On Linux EC2

installing and configuring latest magento 2 on linux

This guide explains the steps to install and configure latest Magento 2.x on a Linux ec2 cloud server or a VPS. We will be doing the following.

  1. Setting up LAMP Stack (Mysql version 5.6 or later)
  2. Setting up Database and user (CLI and PHPMyAdmin)
  3. Setting up Magento 2.0 using composer.

I am using an Ubuntu 14.04 LTS server from Amazon ec2. This tutorial will work on any cloud or VPS having a Ubuntu server.

Setup LAMP Stack

1. Update the Server

sudo apt-get update -y

2. Install apache

sudo apt-get install apache2

3. Install MySQL server and the PHP module for MySQL. During installation, MySQL would prompt for the password for the root user. Set a strong password.

sudo apt-get install mysql-server-5.6 php5-mysql

4. Create MySQL database directory using the following command.

sudo mysql_install_db

5. Run the MySQL secure installation command.

sudo mysql_secure_installation

The above command would prompt for the root password. Enter the root password and proceed with the options given in the output below.

Enter current password for root (enter for none):

Change the root password? [Y/n] n
 ... skipping.

Remove anonymous users? [Y/n] y
 ... Success!

Disallow root login remotely? [Y/n] y
 ... Success!

Remove test database and access to it? [Y/n] y

Reload privilege tables now? [Y/n] y
 ... Success!

6. Install PHP.

sudo apt-get install php5 libapache2-mod-php5 php5-mcrypt

7. Open /etc/apache2/mods-enabled/dir.conf file using vi or nano editor.

 sudo vi /etc/apache2/mods-enabled/dir.conf

The file would look like the following.

    DirectoryIndex index.html index.cgi index.pl index.php index.xhtml index.htm

Move index.php to first so that the file would look like the following.

    DirectoryIndex index.php index.html index.cgi index.pl i index.xhtml index.htm

8. Restart apache server.

sudo service apache2 restart

9. To know all the PHP details, create a file named info.php

sudo vi /var/www/html/info.php

Copy the following contents on the info.php file.


Now, if you browse to http://<Server-IP>/php.info, you will be able to see all the PHP configuration details.

Install and Configure PhpMyAdmin

PhpMyAdmin is a great utility for managing databases through GUI. Follow the steps carefully for setting up PhpMyAdmin.

1. Install PhpMyAdmin

sudo apt-get install phpmyadmin -y

When it prompts for web server, press space bar and select apache2 and press enter. For Configure database for PHPMyAdmin, press enter. Password of the database’s administrative user, enter the root password for MySQL that you created during MySQL installation. Enter the same password for confirmation.

2. Enable PHP mcrypt module.

sudo php5enmod mcrypt

3. Restart the web server.

sudo service apache2 restart

Now you can access the PhpMyAdmin Web UI by visiting the ec2 public IP address followed by PHPMyAdmin as shown below.


You can use the MySQL root credentials to log in to PHPMyAdmin account.

Create Magento User and Database

You can create MySQL user and Database using the command line as well through PhpMyAdmin. Using PHPMyAdmin is self-explanatory. If you want to use the command line for creating the user and database, you can follow the steps given below.

1. Sign into MySQL client using the root user and password.

mysql -u root -p

2. Create database Magento.


3. Create a magento_admin with a strong password. Replace “password” with your strong password.

CREATE USER magento_admin@localhost IDENTIFIED BY 'password';

4. Grant all privileges to magento_admin for Magento database. Replace password accordingly.

GRANT ALL PRIVILEGES ON magento.* TO magento_admin@localhost IDENTIFIED BY 'password';

5. Flush all the privileges and exit the MySQL CLI.


Setting up Magento

In this section, we will configure Magento using LAMP stack. Follow the steps carefully.

1. Create a file called magento.conf in the apache sites available folder.

sudo vi /etc/apache2/sites-available/magento.conf

Copy the following content on the file.

<VirtualHost *:80>
 DocumentRoot /var/www/html
 <Directory /var/www/html/>
 Options Indexes FollowSymLinks MultiViews
 AllowOverride All

2. Enable our new conf and disable the default conf using the following commands.

sudo a2ensite magento.conf
sudo a2dissite 000-default.conf

3. Reload the apache service.

sudo service apache2 reload

4. Open php.ini file to increase the memory_limit parameter to 512M (default 128M).

sudo vi /etc/php5/apache2/php.ini

Find memory_limit parameter and set it to 512M and save the file.

memory_limit = 512M

5. Install required PHP modules for Magento.

sudo apt-get -y install libcurl3 php5-curl php5-gd php5-mcrypt php5-intl php5-xsl

6. Enable rewrite, mcrypt module and restart the apache server.

sudo a2enmod rewrite
sudo php5enmod mcrypt
sudo service apache2 restart

Setup Magento 2.X

1. Install Composer.

curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/local/bin --filename=composer

2. Create a Magento marketplace account and get public and private access keys from your account. Refer this link for getting the public and private keys

3. Create an auth.json file

sudo vi /root/.composer/auth.json

Copy the following content on to the file with your public and private key.

"http-basic": {
      "repo.magento.com": {
         "username": "edd45269f04a6ca51cbbbed2fedab26b",
         "password": "ef88687a5cf5d109c5540ff401b0b903"

4. Get the latest Magento binaries using git.

If you don’t have git installed, install it using the following command.

sudo apt-get install git -y

Clone the magento2 community version code to Magento directory.

git clone -b 2.0 https://github.com/magento/magento2.git magento

5. Copy all files to /var/www/html directory using rysync.

sudo rsync -avP magento/. /var/www/html/

6. CD into /var/www/html folder and install all the required Magento modules using composer.

cd /var/www/html
composer install

7. Change the owner of /var/www/html to www-data.

sudo chown -R www-data:www-data /var/www/html/

8. Visit the public IP of your server. You will see the Magento setup page as shown below.

magento initial setup


9. Click agree and setup. Click next for database settings.

magento 2 initial setup


10. Enter the database username , password and database name you have created under MySQL configuration as shown below. Click next after entering the details.

magento database configuration


11. Next page, you can see the store and admin page address. You can customize the admin age path. If you have a domain name, you can map the domain name to the IP address.

magento 2 admin url confirations


From this point, you can click next and fill in the details. In the last page, click “Install” option. Once installed, you will get all the details of your Magento site as shown below.


magento final installtion

1 comment
  1. Thanks for sharing this article, it really helped me a lot, i was installing magento on Amazon aws, got stuck while adding .ppk file, i got help from your post.

Leave a Reply

Your email address will not be published. Required fields are marked *

You May Also Like