---
layout: post
title: How to install Magento on Ubuntu
author: David T. Sadler
description: By the end of this guide you will have installed Magento locally on Ubuntu.
categories: ["Magento","Ubuntu"]
robots: follow, noodp, noydir, noarchive
comments: true
google_plus: true
twitter_share: true
facebook_like: true
published: false
---
By the end of this guide you will have installed Magento, and some sample data, locally on Ubuntu. This will allow you to get to grips with the software before installing it onto a production server. In addition to Magento I will take you through installing Apache, PHP and MySQL. I'm going to assume that you are using Ubuntu 11.10 (Oneiric Ocelot) and that you wish to install version 1.6.2.0 of Magento. You're results may vary if you are using different versions.

As this is quite a long post I have broken it down into various sections. Feel free to ignore those parts that are not relevent for you.

* [Getting started.](#start)
* [Installing and configuring the Apache HTTP server.](#apache)
* [Installing the PHP scripting language.](#php)
* [Installing the MySQL database server.](#mysql)
* [Creating the directory from which Magento will be served from.](#directory)
* [Configuring the Apache Virtual Host.](#vhost)
* [Installing Magento.](#magento)

<h2 id="start">Getting started.</h2>

If you have never heard of Magento the following from the <a href="http://www.magentocommerce.com/" rel="external nofollow" target="_blank" title="Go to the Magento website">website</a> will explain.

<blockquote cite="http://www.magentocommerce.com/product/faq#What%20is%20Magento?">
  <p>Magento is a feature-rich eCommerce platform built on open-source technology that provides online merchants with unprecedented flexibility and control over the look, content and functionality of their eCommerce store. Magento’s intuitive administration interface features powerful marketing, search engine optimization and catalog-management tools to give merchants the power to create sites that are tailored to their unique business needs. Designed to be completely scalable and backed by Varien's support network, Magento offers companies the ultimate eCommerce solution.</p>
  <footer>&mdash; <cite><a href="http://www.magentocommerce.com/product/faq#What%20is%20Magento?" rel="external nofollow" target="_blank" title="Go to the Magento FAQ">Magento Frequently Asked Questions</a></cite></footer>
</blockquote>

Magento is available in two editions, Community and Enterprise. The Enterpise edition is the company's commercial version of the software and is meant for large-scale eCommerce users. The Community edition on the other hand is available as a free download under the open source OSL 3.0 license and is the version that you will be installing.

This post will walk you through every thing you need to get a local copy of Magento running on Ubuntu. It is not meant as a guide to installing a fully working eCommerce store located on a production server.

To begin, open up a terminal and enter the command below.

{% highlight bash %}
sudo apt-get update
{% endhighlight %}

This will ensure that the computer's database of software packages is updated to contain the latest versions. While this command is not strictly necessary, I tend to issue it before installing any software so that the most up to date versions of the packages are used.

<h2 id="apache">Installing and configuring the Apache HTTP server.</h2>
Apache is easily installed by entering the following command.
{% highlight bash %}
sudo apt-get install apache2 -y
{% endhighlight %}

During the install you may notice the following warning:
{% highlight console %}
apache2: Could not reliably determine the server's fully qualified domain name, using 127.0.1.1 for ServerName
{% endhighlight %}

This comes from Apache itself and means that it was unable to determine its own name. The Apache server needs to know its own name under certain situations. For example, when creating redirection URLs.

To stop this warning we can create an Apache config file to store the name. On a production server you would set this as either a hostname or a <abbr title="Fully Qualified Domain Name">FQDN</abbr>, but for local development we can get away with using 'localhost'.

{% highlight bash %}
sudo bash -c "cat >> /etc/apache2/conf.d/servername.conf <<EOF
ServerName localhost
EOF"
{% endhighlight %}

In order for this change to take effect restart Apache. The warning should no longer appear.

{% highlight bash %}
sudo service apache2 restart
{% endhighlight %}

One of the features of Magento is its URL rewriting. By default Magento will use category and product IDs when generating URLs. With the rewrite tool you can create more SEO friendly URLs for your store. So rather than the URL below,

{% highlight console %}
/catalog/product/view/id/16
{% endhighlight %}

you can instead use,

{% highlight console %}
/size-6-red-shoes.html
{% endhighlight %}

In order to take advantage of this feature we need to enable Apache's rewrite module with the `a2enmod` command.

{% highlight bash %}
sudo a2enmod rewrite 
sudo service apache2 restart
{% endhighlight %}

<h2 id="php">Installing the PHP scripting language.</h2>
asfsadfdsfsdfs

<h2 id="mysql">Installing the MySQL database server.</h2>
asfdsfsd

<h2 id="directory">Creating the directory from which Magento will be served from.</h2>
asfdsafdf

<h2 id="vhost">Configuring the Apache Virtual Host.</h2>
safsdfsdfdsf

<h2 id="magento">Installing Magento.</h2>
sfsdafdsfad