Are you thinking of installing Joomla or would you like to build a website easily and are just looking for some help?
Joomla’s installation process is quite easy for most people but most beginners get lost while installing it and if you feel a bit lost about it, then we are here to help you out.
In this tutorial on how to install Joomla, we will help you out with Joomla’s installation process and how to set it up correctly so you can deploy a Joomla site in less than an hour.
Keep in mind that in this article we’ll manually install Joomla on a remote server but if you wish to install it locally then the process is very similar.
What is Joomla?
Joomla is the world’s fifth most used Content Management System (CMS). It is free, open source, and is considered one of the easiest ways to put up a website online. It is a direct competitor of another open-source CMS called WordPress, and if you want to host a WordPress site, check out our WordPress Server Hosting options.
Joomla uses open-source technologies such as PHP and MySQL database to operate. As of today, Joomla is used by over 2.5 million people around the world and it includes more than 6500 extensions to offer even more customization for it’s users.
To put it simply, Joomla lets people publish a website on the internet without the need of knowing how to code. It includes templates that let people choose their website appearance and it includes features such as article publishing, user management, an admin dashboard, and various other types of plugins to give you even more control over your website.
Did you know that over 2.8 percent of the websites on the internet run on Joomla and there is a chance that some of your favorite websites might be built with Joomla.
Joomla may not be the ideal solution for everybody who wishes to own a website but on the other hand, it offers some neat features such as easy content management, high security, and multi-language support that makes it a good choice for small businesses and individuals who would like to own a web site.
Joomla also does not require prior technical knowledge or knowing how to code. You could easily follow some steps in this tutorial to install it; and managing it is even easier.
Benefits of Joomla
- Free & open source
- SEO optimized
- Easy to use
- Secure and stable
- Mobile friendly
- Fast & Highly Scalable
Before we begin…
So now we’ll show you how to install and set up Joomla 4 (the latest version) but before we begin you need to have an Ubuntu server up and running. For a quick deployment, check out our cloud VPS options.
SSH into your remote server
To SSH into your remote server type this command on your terminal:
ssh -i [.PEM_FILES_LOCATION] [USERNAME]@[IP_ADDRESS]
The first parameter is your .pem file’s location and the second parameter is your server’s IP address.
Update your linux packages
Update your Linux packages by running these commands:
sudo apt-get update
sudo apt-get update
Install some necessary packages
Install apache server by typing the command below:
sudo apt-get install apache2
Why? Because we need the apache web server software to serve our Joomla files on the server.
To check you apache server’s version run this command:
Now we need to Install PHP and some other libraries required for Joomla. If you already have PHP installed on your server, make sure that the PHP version is higher than 7.2.5.
sudo apt-get install php libapache2-mod-php php-mysql php-curl php-gd php-pear php-imagick php-imap php-pspell php-tidy php-xmlrpc php-xml
Why? Because as we said before Joomla requires PHP and other libraries in order to operate.
Install unzip by running this commands:
sudo apt-get install unzip
Why? Because we need to unzip the Joomla files later on using this tool.
The last package that we need to install is MySQL. To install it, run this command:
sudo apt-get install mysql-server
Setup a MySQL database
Before we continue on, we need to setup our MySQL server correctly.
Access your MySQL shell with the root user by typing this command below:
sudo mysql -u root -p
Hint: if you don’t have any password for your root user then click enter to continue.
Create a mysql database by the name of Joomla.
CREATE DATABASE joomla;
Create a user and a give it whatever password you want.
CREATE USER '[USERNAME]'@'localhost' IDENTIFIED BY '[PASSWORD]';
Note! Remember this username and password as we need it later on.
Grant full access of your Database to your newly created user using this command:
GRANT ALL ON joomla.* to '[USERNAME]'@'localhost';
Exit the MySQL shell
Now that the database configuration is done and we have downloaded the necessary packages it is the time to set up Joomla it self by following these steps:
Change your directory to apache’s root directory
As you can see, we have only index.html in the directory which is the default file. To check this file, write your IP address in a web browser and you shall see this.
Now we need to download the latest version of Joomla in our current director. You need to visit their website and copy Joomla’s latest download Link.
sudo wget [JOOMLA'S DOWNLOAD LINK]
Now that we have the Joomla .zip file we need to unzip it using the library that we have installed previously.
sudo unzip [THE NAME OF THE FILE]
Now in order that Joomla may operate correctly we need to grant Joomla permission by typing these commands:
sudo chown -R www-data:www-data /var/www/html
sudo chown -R 755 /var/www/html
Now you can type ls on your terminal and see the file structure of Joomla.
Now that most of the things are set up correctly we need to delete the two extra files: the .zip file and the default index.html file since they are no longer needed. To do this, use the following command:
sudo rm index.html
sudo rm -fr [JOOMLA FILE NAME]
The last step would be to restart our apache server and then we’ll see the Joomla app being run on the server’s IP address.
To restart the server, type in the following command:
sudo systemctl restart apache2
Now you can open your browser and type your IP address to see the Joomla Installer.
Common Setup Error
If you are getting the below error, then you have a problem with your permissions. It is better to type those permission commands again and restart the server. If you are still getting the same error message then it is recommended to delete everything in the directory and start again.
An error has occurred while processing your request. 0 Failed opening required '/var/www/html/joomla/administrator/cache/autoload_psr4.php' (include_path='.:/usr/share/pear:/usr/share/php:/usr/share/pear:/usr/share/php')
Now that we have successfully setup our server to host Joomla site it’s now time to configure Joomla itself.
At the first page you need to enter your site name.
Now you need to setup login data. For that you need to enter your name, a username, a password and your email address. By using this username and password you will then be able to login to your Joomla admin dashboard so be wise to choose a good password and your username must be more than 4 digits.
At last you need to configure your database connection to Joomla. In this page you need to enter the following:
- Database username
- Database user’s password
- Database name
The username is joomla_user, database name is joomla, password is what you have chosen earlier and every other parameter should be as default.
Congratulations! you have now successfully installed and configured Joomla on your Ubuntu server.
Joomla Admin Panel
Now you can access your website at your IP address. Additionally you could open the admin panel by moving to [YOUR IP]/ administrator path.
This is the admin panel’s login page, you need to enter the admin username and password that you had previously chosen and login to your admin panel.
By using this admin panel the possibilities are endless you could manage your site, write articles, manage your users and much more.
Now that you own a Joomla site it does not stop there. You can now edit your site in numerous ways. For example, you can add a different template, additional languages to your site, or a domain name for customers to easily access your website.
Joomla is a fast growing software. From the time it was released in 2005, until now, it has been sky rocketing in popularity and usage. To say Joomla is one of the best CMS’ out there would not be wrong. If you are someone who needs to build a website to share content on the internet, Joomla is the right choice for you.