Tutorial

How To Install Magento on a VPS running Ubuntu 12.04

Published on February 19, 2014
How To Install Magento on a VPS running Ubuntu 12.04
Not using Ubuntu 12.04?Choose a different version or distribution.
Ubuntu 12.04

Status: Deprecated

This article covers a version of Ubuntu that is no longer supported. If you are currently operate a server running Ubuntu 12.04, we highly recommend upgrading or migrating to a supported version of Ubuntu:

Reason: Ubuntu 12.04 reached end of life (EOL) on April 28, 2017 and no longer receives security patches or updates. This guide is no longer maintained.

See Instead: This guide might still be useful as a reference, but may not work on other Ubuntu releases. If available, we strongly recommend using a guide written for the version of Ubuntu you are using. You can use the search functionality at the top of the page to find a more recent version.

About Magento


Magento is an e-commerce open source web application owned by eBay.inc. It is a widely used software for which a big community contributes and was built using components from the Zend Framework. It is built in PHP (5.2.13+), works with MySQL as a storage engine, and can be run using the Apache web server.

In this tutorial, we will see how to install Magento from the command line onto a VPS running Ubuntu 12.04. For this I assume you already have your virtual server up and the requirements mentioned above are taken care of. If you have not yet set up LAMP stack (Linux, Apache, MySQL, PHP), follow the instructions provided in this article to get you going.

Setting up the environment


There are a couple of steps we need to take before the actual installation process to make sure Magento will run on our VPS.

First thing we should take care of is allow Magento to use enough PHP memory (it is recommended that PHP should be allowed 512 MB of RAM). To do this, edit the php.ini file:

nano /etc/php5/apache2/php.ini

And where you see this line:

memory_limit = 128M

Change it to:

memory_limit = 512M

Of course you may have that already or a different value – but you understand the point.

A next thing we’ll need to take care of is a couple of PHP extensions (if you don’t already have them installed). Run the following commands to take care of them:

sudo apt-get install libcurl3 php5-curl php5-gd php5-mcrypt

Since we are using Apache as a webserver and Magento can make use of URL rewriting, we’ll need to also make sure that Apache will in fact let it do that. If you haven’t already done the following steps, you’ll need to do them now.

Edit the virtual host file that is responsible for the folder where Magento will be installed (in our case, the default Apache document root: /var/www):

sudo nano /etc/apache2/sites-available/default

Inside the block marked with this beginning:

<Directory /var/www/>

Make sure that instead of AllowOverride None you have AllowOverride All.

Next thing we need to do is enable mod_rewrite (again if you don’t already have it enabled). To check if it’s already enabled, use the following command:

apache2ctl -M

If you see “rewrite_module” in the list, you are fine. If not, use the following command to enable the module:

a2enmod rewrite 

Magento also requires the option to send out emails from the virtual server if you do not connect it to an SMTP server. For this, let’s quickly install Sendmail with the following commands:

sudo apt-get update
sudo apt-get install sendmail

Then run this command to promot the interactiv configuration of sendmail (you can answer yes to the questions):

sudo sendmailconfig

After all or some of these changes, restart the server to make sure the changes have taken effect so run the following command to do that:

sudo service apache2 restart

Database


Since you need a database to run Magento, let’s get that out of the way as well before installing the software itself. I will guide you through some quick steps to set up your MySQL database, but there is a good tutorial with more information you can check out on the topic.

The first thing you need to do is login to mysql from your terminal (you can use PHPMyAdmin as well if you want, but I will show you how to do it from the command line):

mysql -u username -ppassword

From there, run the follwing command to create a database called magento:

create database magento;

You can of course change its name to something else if you want. And that’s pretty much it. When we run the installer for Magento, you’ll specify the information to connect to this database.

Installation


In this tutorial we install Magento straight into the root directory of our Apache webserver (/var/www). To do this, navigate to that folder:

cd /var/www

And run the following command to download the software:

wget http://www.magentocommerce.com/downloads/assets/1.8.1.0/magento-1.8.1.0.tar.gz

Please note that in this command I specify the latest release at the time of writing. Make sure you adapt the URL to download the latest stable release when you install. You can check the Magento website for that.

Next, let’s untar the file we just downloaded:

tar -zxvf magento-1.8.1.0.tar.gz

This will create a folder called magento that houses all the software files. You can go ahead and remove the .tar file since you won’t be needing it after this step:

rm magento-1.8.1.0.tar.gz

Since Magento will run from within the webserver document root, let’s move all the files and folders that belong to the software into the /var/www folder:

mv magento/* magento/.htaccess .

Next, let’s make sure some application folders can be written by the web server. While being in the /var/www folder, run the following commands:

chmod -R o+w media var
chmod o+w app/etc

This will give permissions to the Apache user to write in these folders. Now it’s time to go to the browser and run the web installer. Navigate therefore to your VPS IP address and you should see a welcome page:

Welcome to Magento's Installation Wizard!

Read and agree to the terms and conditions and press Continue. On the next screen you have to select your locale information (language, default currency, etc). After doing that, move on to the next screen. It follows to enter the database information and credentials (remember the db we just created?). You can leave the Host field as it is and unless you really want table prefixing, leave that field empty as well.

Right below the db information, you can specify some other global settings. Enter the base url you’ll want to have (this is probably the domain name that will be tied to your VPS IP) and the admin path. You can check the next box as well since we enabled our webserver to allow .htaccess rewrites:

Use Web Server (Apache) Rewrites

An important thing to note about the the last checkbox in this section is that you can only enable it if you have SSL on your virtual server. This means only if your server has enforced HTTPS URLs and contains a valid SSL certificate to secure them.

Final Thoughts


Since you are installing an ecommerce platform, doing these things is highly recommended. Handling payments over non-secure connections is unsafe. For more information about how you can set up your own SSL certificate and enforce traffic through HTTPS, read this article. It 's not enough, however, for production e-commerce sites where a third party certificate provider should be used for guaranteeing the certificate.

Having said all that, if you are installing Magento for the sake of testing the product, you can leave the SSL checkbox unchecked and not have to worry about it.

The last setting on this screen pertains to where the session information should be written (the file system or the database). Make your selection based on what best fits your needs and you can proceed to the next screen.

Fill in your basic information and access credentials here and you are all set. You can choose to go straight to the backend or frontend. Magento is now installed – Congratulations!

<div class=“author”>Article Submitted by: <a href=“http://www.webomelette.com/”>Danny</a></div>

Thanks for learning with the DigitalOcean Community. Check out our offerings for compute, storage, networking, and managed databases.

Learn more about us


About the authors

Still looking for an answer?

Ask a questionSearch for more help

Was this helpful?
 
7 Comments


This textbox defaults to using Markdown to format your answer.

You can type !ref in this text area to quickly search our full set of tutorials, documentation & marketplace offerings and insert the link!

Thanks for sharing this article. It is really helpful for someone who is new to the industry as it explains the whole scenario in a pretty simple way. However, if any of you is still having difficulties in the installation or not looking for total sys-admin control then here is a blog post on how to install Magento on digitalOcean which might help you.

hello,

my problem is sendmail is only sending emails to gmail acconunt.

If I try to send email to hotmail or other I wont receive it.

Can anybudy help me with this?

Thanks

Hi, thank u for the tutorial. However, I did all the steps but I didn’t see the magento welcome page in the VPS ip ADRESS. thanks

ServerPilot (https://serverpilot.io/) is generally a safer way to run Magento on Ubuntu if you aren’t familiar with system administration.

I’m not sure if it’s because of me running Ubuntu 14.04, but the virtual host file to edit AllowOverride was in: /etc/apache2/apache2.conf

instead of /etc/apache2/sites-available/default

Hello, I have a question it is possible to run the magento code version 1.8.1.0 in cheaper package of digitalocean like 512MB memory? I’m having a troubled after I installed it when I goto the magento/admin I experienced mysql/socket error to resolved this mysql issue I need to restart my mysqlserver.

Regards Armin

Very helpfull, thanks.

Try DigitalOcean for free

Click below to sign up and get $200 of credit to try our products over 60 days!

Sign up

Join the Tech Talk
Success! Thank you! Please check your email for further details.

Please complete your information!

Get our biweekly newsletter

Sign up for Infrastructure as a Newsletter.

Hollie's Hub for Good

Working on improving health and education, reducing inequality, and spurring economic growth? We'd like to help.

Become a contributor

Get paid to write technical tutorials and select a tech-focused charity to receive a matching donation.

Welcome to the developer cloud

DigitalOcean makes it simple to launch in the cloud and scale up as you grow — whether you're running one virtual machine or ten thousand.

Learn more
DigitalOcean Cloud Control Panel