There is a new version of this tutorial available for Ubuntu 22.04 (Jammy Jellyfish).

How to install Joomla on Ubuntu 14.04

Version 1.0
Author: Srijan Kishore

This document describes how to install and configure Joomla on Ubuntu 14.04. Joomla is an immensely popular and award-winning open source Content Management System (CMS) that enables users to build websites and create potent online applications in an unperturbed manner. Absolute user-friendliness and flexibility make Joomla amongst the most sought-after CMS softwares. It uses a PHP application, in addition to a backend database like MySQL. Joomla was created in 2005, and boasts of more than 10,000 add-ons for customized functionality-no wonder than that it remains the second most popular virtual content management site. This tutorial explains the process of installing Joomla on Ubuntu 14.04 in the form of a simple-to-follow guide.

1 Preliminary Note

This tutorial is based on Ubuntu 14.04 server, so you should set up a basic Ubuntu 14.04 server installation before you continue with this tutorial. The system should have a static IP address. I use as my IP address in this tutorial and as the hostname.  You must have a LAMP server installed in Ubuntu 14.04 as mentioned in the tutorial to continue further.

2 Database initialization

I will create  the database for the Joomla as follows:

mysql -u root -p

Here we are adding database=joomladb user=joomlauser and password=joomlapassword:

CREATE USER [email protected];
SET PASSWORD FOR [email protected]= PASSWORD("joomlapassword");

Giving priveleges to the user, here two cases lies if the LAMP is made of Mairadb-server or Mysql-server. The command differ in both cases so I will mention the difference here:

For Mariadb-server use:

GRANT ALL  ON `joomladb`.* TO `joomlauser`@`localhost` IDENTIFIED BY 'joomlapassword';

And for Mysql-server use:

GRANT ALL PRIVILEGES ON joomladb.* TO [email protected] IDENTIFIED BY 'joomlapassword';

Further moving ahead:


Restart services

service apache2 restart
service mysql restart


3 Installation of Joomla

We will first make a directory temp in which I will the download the latest version of the Joomla as follows:

mkdir temp
cd temp

We need to install unzip as by default it is now installed:

apt-get install unzip

Now create a directory  /var/www/html/joomla and unzip the Joomla zip file in the newly created folder:

mkdir -p /var/www/html/joomla
unzip -q -d /var/www/html/joomla

Now give appropriate permissions in the directory

chown -R www-data.www-data /var/www/html/joomla
chmod -R 755 /var/www/html/joomla

Now proceed to the web installation of Joomla. Go to the URL

Now give the values as I gave in my case

Site Name = joomla_test_site
Description = joomla_test_site
Admin Email = [email protected]
Admin Username = admin
Admin password = howtoforge
Confirm Admin Password = howtoforge

The above values will differ in you case, you can give any values of your choice. After giving the values press Next:

Further fill the values in next page as you mentioned wile creating the database of the joomla, as in my case I gave the values as follows:

Database Type =	MySQLi
hostname = localhost
username = joomlauser
password = joomlapassword
Database Name = joomladb
Table Prefix = jml_

For Table Prefix you can use any character as I gave jml_ in my case. If you wish to add the FTP Configuration then you can put the values, in my case I am skipping this step as it is also recommended. Press Next:

For then next tab I will select the Brochure English (GB) Sample Data and press Install:

It will install Joomla. Now you need to delete the installation folder by using Remove Installation Folder:

Now you can access the admin panel at give the credentials as you gave at the time of Joomla installation:

In my case values are:

username = admin
password = howtoforge

It will launch the default webpanel of Joomla.

Cheers you have done with the Joomla installation in Ubuntu 14.04 :)

Share this page:

Suggested articles

20 Comment(s)

Add comment


By: Dr_who

Hi all

have try this and trying to upgrade to 3.3.5 but are getting this error : Error : Ajax Loading Error : 

how 2 fix it ???


By: iniaski

Thanks a lot for your very complete explanation. I have searched the web fior similar articles, but yours is the most complete, understandable and clear. Everything was fine adn worked perfect. Thanks again.

By: sanjay

it is very easy step by step procdure to install joomla which i have search on web

By: Andy

Great tutorial, very useful

By: GeorgeM

much appreciated the effort to put together this great tutorial.

By: sur_clive

Wow, installed it in some 10 minutes, and it's working! Thanks a lot! 

By: Ole Friis

Great tutorial, very useful, but missing new prompt when entering "mysql -u root -p"

Thanks anyway.

By: Toby

Great work, this is a real usefull Tutorial, thanks a lot.

By: tou

thank you very usefull

By: Rodrigo

Definitely a clear and complete tutorial. Congrats for this great job!

By: Jakke

It's really crappy to build a tutorial, have people asking questions (Ajax loading error) and not reply to it.

I've got the same problem, I'll know I'll find a solution somewhere but if you're not willing to support your tut/explanation, then the whole value of this tut is worthless.

By: till

Support for the tutorial is available in our forum:

By: Sujan Swearigen

It seems to be a good tutorial overall.  However, this does not work well.  There is not a clear explaination about the users that MySQL needs and the permissions required for Joomla.  The Joomla management console eventually loads but does not save data and keeps reloading.  Who is www-data?  Does this user need to be added to the server?  Does this user need to be added to MySQL?  The Joomla support community does not seem to be helpful at all.  These issues would not even arise if people would have done as they were supposed to from the beginning.

By: till

The MySQL user is created in chapter 2 "Database Initialisation" of this tutorial. The user and password that you add there is later used to setup joomla.

By: James

Will this work on Ubuntu 14.04 Desktop instead of 14.04 server?

By: James

Why did you include nothing about the apache web container installation? And what the 'www-data' user? This does not exist on my Ubuntu 14.04 install. Please clarify.

By: till

Please read chapter 1 of the guide, it tells you to install apache and mysql as shown in this tutorial first:

By: Neil Taylor

I've installed Joomla successfully on Ubuntu 16.10, but when I enter Site Name, Admin Email, etc on http://......../joomla/installation/index.php#, then press 'Next', the values are cleared and I'm informed that Site Name, Admin Email, etc are required fields.

By: artiommax

for some reason when i am setting up mysql it says it can't connec to mysql database


By: halk

I have erred at some point - even though the joomla installation has unziped into /var/www/html/joomla I am receiving a 404 error and I can't solve the issue. It may be that the databases in MySQL have not been properly setup and proper permissions set; however I can't seem to get back to configuring MySQL to add the data bases. I am an old unix user but it has been quite awhile so I am requesting your assistance (i.e. as though I am a complete newbie). I hope you can help. The instructions are really useful and appreciated, I just didn't follow them correctly.  Thank you for your good advice.