====== Joomla Installation ======

This guide will explain how to get up and running with Joomla on LiteSpeed Web Server.

===== Install PHP modules =====
The easiest way to install PHP for LiteSpeed is through our CentOS repository. If the LiteSpeed Repository was not installed and enabled during the web server installation, follow [[http://www.litespeedtech.com/support/wiki/doku.php?id=litespeed_wiki:php:rpm | this guide]] to install and enable the LiteSpeed Repository.
===Step 1.Install PHP===
You can install some of the most commonly-used PHP 7.1 packages and modules for LiteSpeed. Use the following command:

<code>sudo yum install lsphp71 lsphp71-mysqlnd lsphp71-common lsphp71-gd lsphp71-pdo lsphp71-process lsphp71-mbstring lsphp71-mcrypt lsphp71-opcache lsphp71-bcmath lsphp71-xml lsphp71-soap lsphp71-json -y </code>
===Step 2.Setup PHP===
Visit ''<nowiki>http://your_server_IP:7080</nowiki>''. Navigate to **Server Configuration > External app**, then click the second icon **Edit** on the right hand side in order to edit this application.\\
Modify:
  * **Name**: lsphp -> ''lsphp71''
  * **Command**: $SERVER_ROOT/fcgi-bin/lsphp5 -> ''$SERVER_ROOT/lsphp71/bin/lsphp''
===Step 3.Restart LSWS===
When you are finished, click the **Save** icon to save your changes, then click the **Graceful Restart** button.
===Step 4. PHP Verification===
Visit ''<nowiki>http://your_server_IP/phpinfo.php</nowiki>'' and make sure **PHP Version** shows ''7.1.x''.


=====MariaDB Installation:=====
Install MariaDB:
<code>sudo yum install mariadb-server
sudo systemctl start mariadb</code>
Set new password: 
 <code>/usr/bin/mysql_secure_installation</code>
Enter ''$yourpassword''
=====Create Joomla DB Account =====
Create the Joomla database and your Joomla user/password:
<code> mysql -u root -p$yourmysqlpassword
 create database joomla; grant all privileges on joomla.* to joomla@localhost identified by 'joomla'; exit;</code> 
Note: For security purposes, you should use a Joomla username and password that are different than our example.

===== Set Index File =====

An index file needs to be set in LiteSpeed Web Admin Console. Navigate to **Virtual Hosts > Select Virtual Host from List >  General > Index Files**, click **Edit** in the top right corner, and enter **index.html,index.php** in the **Index Files** box.

{{ :litespeed_wiki:installation:selection_010.png?600 |}}

===== Download and Extract Joomla =====

To illustrate setting up Joomla on a vhost we'll use the default virtual host, “Example”. You can download Joomla from their official [[https://downloads.joomla.org/|download page]]. 

Please note that the document root of 'Example' virtual host is **/usr/local/lsws/Example/http/**


<code>
unzip Joomla_x.x.x-Stable-Full_Package.zip
</code>


===== Joomla Installation =====

Open the browser with the URL ''<nowiki>http://server_IP:8088/</nowiki>''

This will start the Joomla web installer and it will look something like this:

{{ :litespeed_wiki:installation:joomla-1.png?600 |}}

==== General Configuration ====

On this page the installer asks some general questions about the site. You can fill them in as required. An example configuration is given below:

  * **Site Name:** ''Litespeedtech''
  * **Description:** ''Installation Demo''
  * **Email:** ''example@example.com''
  * **Username:** ''litespeedtech''
  * **Password:** ''litespeedtech''

Once done, click **Next**.

==== Database Configuration ====

{{ :litespeed_wiki:installation:joomla-db.png?600 |}}

We've already created the database above. Just enter details and click **Next**.

==== Overview ====

This is the last step before the Joomla installer starts the installation process. Usually in this window you don't need to do anything. The installer will verify that all server-side requirements are met, and if you have correctly followed the guide, then it should not give you any errors. Click **Install**.

==== Remove Installation Folder ====

Once the installation is successful you can remove the installation folder.

{{ :litespeed_wiki:installation:joomla-remove-installation-folder.png?600 |}}

You cannot use the Joomla installation until the installation folder is removed. You can also remove it from the command line using:

  rm -rf installation

Now if you visit  ''<nowiki>http://server_IP:8088/</nowiki>'', you will see the Joomla home page. The administration area can be found at ''<nowiki>http://server_IP:8088/administrator</nowiki>''