IconsPage/important.png This guide was written for Ubuntu Server 20.04 and Joomla 4.0 The guide may be applicable for other version of Joomla!, Ubuntu or other Debian based distributions, but they have not been tested. If you have success with using this guide on other versions of Ubuntu or other Debian based distributions please feel free to add a note to this document.

Joomla! Community Documentation

Joomla! provides an online collaborative community manual for Joomla! users, developers or anyone interested in learning more about Joomla! Currently, they have over 4000 articles written and maintained by Joomla! community members.

PREPARE FOR INSTALLATION

This guide assumes you have installed a LAMP SERVER. See: LAMP_SERVER. NOTE: The command line in the instructions to install the LAMP SERVER are incorrect, the correct command line is: sudo tasksel install lamp-server^

There are several prerequisites before you start installing Joomla!.

PHP settings must be adjusted to install. The settings are usually in "/etc/php/7.4/apache2/php.ini"

The values for PHP.INI below are suggested values only.

 memory_limit - Minimum: 64M Recommended: 128M or better
 upload_max_filesize - Minimum: 30M
 post_max_size - Minimum: 30M
 max_execution_time: Recommended: 30

2. Create the MySql Database, the "JoomlaUser" and Grant Permissions to the Database

_Write this Information Down_

 sudo mysql -u root -p
 CREATE DATABASE joomla;
 CREATE USER 'joomlauser'@'localhost' IDENTIFIED BY 'new_password_here';
 GRANT ALL ON joomla.* TO 'joomlauser'@'localhost';
 FLUSH PRIVILEGES;
 EXIT;

SECURITY NOTE You do not want Joomla to use the mysql 'root user' to access the database. The above command creates a mysql user (other than the mysql root user) with privileges to use the joomla database. You will need to chose the yourusername and yourpassword.

3. Activate Uncomplicated FireWall

 sudo ufw enable
 sudo ufw allow 'Apache Full' 

An introduction to UFW can be found here: UFW

DOWNLOAD JOOMLA!

1. Create a temporary directory to download and extract the Joomla package.

 mkdir joomla
 cd joomla
 sudo wget -O joomla4.zip https://downloads.joomla.org/cms/joomla4/4-0-3/Joomla_4-0-3-Stable-Full_Package.zip?format=zip
 unzip joomla4.zip
 rm -f joomla4.zip

2. Move the files and change ownership

 cd ..
 sudo mv joomla /var/www
 sudo chown -R www-data:www-data /var/www/joomla

3. Change File, Directory Permissions, Owner and Group

sudo find /var/www/joomla/ -type f -exec chmod 644 {} +
sudo find /var/www/joomla/ -type d -exec chmod 755 {} +
sudo chown -R www-data:www-data /var/www/joomla

YOUR APACHE VIRTUAL HOST

1. Create your Virtual Host

2. Copy the following into your newly created Virtual Host

 <VirtualHost *:80>
     ServerName mynewsite.com
     ServerAlias www.mynewsite.com
     ServerAdmin webmaster@mynewsite.com
     DocumentRoot /var/www/joomla
     LogLevel error
 </VirtualHost>

3. Enable your Virtual Host

 sudo a2ensite mynewsite
 sudo a2dissite 00-default.conf
 sudo systemctl restart apache2.service

START INSTALL

Once the above requirements are met, a database created and the required Joomla! files in place, you are ready to install Joomla!.

Enter https://www.yoursitename.com into your browser, and you should see the installation screen.

1. MAIN CONFIGURATION

Joomla will try to Select the Language automatically from your browser's language. You can change this if needed. Fill in the following information.

2. LOGIN DATA

You should now see the login data screen. Fill in the following information.

When everything on the second page is completed, click the Setup Database Connection button to proceed.

3. DATABASE CONFIGURATION

Grab the information you wrote down when you Created your MySql Database, above.

These instructions are a reference to installing with a MySQLi database. They are on the installation page and are self explanatory, but here they are for reference:

All these choices and more can be edited on the Site Global Configuration page, under Server Options after the installation is completed. Note, you will break your installation if you change these settings after installation unless you have a complete copy of the current database being used by the Joomla installation. Common uses would be to update the username and password of the database or to complete a move of an existing installation to a new host with different parameters.

After you click the Install Joomla button, you should see the Joomla logo spinning. Once the installation completes, you should see the success page!

joomla3.png

FINISHING UP THE INSTALLAION

Congratulations! Joomla! 4 is now installed. If you want to start using Joomla right way without installing extra languages

INSTALLING EXTRA LANGUAGES

A list of language packs is displayed. Select up to 3 languages you wish to install (more than 3 at once can cause timeout issues - you can install more later). Remember the following:

Manager → Update. This behaviour is similar to Extensions Manager → Install Languages.

Click Next and a progress bar will be display while the language pack or packs are installed.

When the installation of the languages is complete you will now be presented with a very similar Congratulations,Your Joomla site is ready. The difference will be a list of the installed languages allowing you to select the default language for the Site and the Administrator interface.

You must now delete the Installation Folder. Click on Remove Installation folder. You will get a confirmation message and now can navigate to the Administrator Dashboard log in by clicking Complete & Open Admin or go right to your site by clicking Complete & Open Site. _

Congratulations and welcome to the world of Joomla!

Joomla (last edited 2021-10-12 01:49:26 by arthurjohnston)