Goals

The goal of this entry is to guide a user in their installation of a Joomla Content Management System.

Sonas was supposed to write this article but seeing as it was created in September and has remained pretty much a stub since, I am taking a shot at it. Old Page

Dependancies

PHP 4.2.x or above - http://php.net

MySQL 3.23.x or above - http://mysql.org

Apache 1.3.x or above - http://httpd.apache.org

Assumptions

I shall assume that PHP and Apache have been set up correctly and that your database is sitting on “localhost”.

I will also assume that a MySQL DB has been made for the joomla installation called “joomla”.

I shall also assume installation taking place on a remote linux hosting/machine.

Please choose the correct section depending on whether you are using FTP or SSH access to your hosting/remote machine

FTP Access

  1. On your computer, navigate to http://www.joomla.org/download.html
  2. Download the .ZIP file containing the latest full package of Joomla.
  3. Create a a folder called “joomla” and unzip the package into this folder.
  4. Upload the “joomla” folder to the main shared directory of your hosting server using your preferred FTP client, e.g. CyberDuck on Mac OS X.
  5. Navigate to “http://YOURDOMAIN.com/joomla” in your browser.

Now refer to the section below marked “Installation”.

SSH/SFTP Access

  1. On your computer, navigate to http://www.joomla.org/download.html
  2. Copy the download link for the .ZIP file containing the latest full package of Joomla.
  3. SSH into your remote machine and use the “su” command to switch to root user if applicable/available.
  4. Navigate to your main web directory. (Usually /var/www/)
  5. Create a a folder called “joomla” using the mkdir command then use “cd” to enter this folder.
  6. Use the “wget” command to download the Joomla .ZIP package.
  7. Use “unzip Joomla_*” to decompress the .ZIP package.
  8. Now do the following commands:
  $  cd .. 
$ chmod -R 777 joomla/
  1. Leave your terminal open. You'll need it later on.
  2. Navigate to “http://YOURDOMAIN.com/joomla” in your internet browser.

Now refer to the section below marked “Installation”.

Installation

I assume you have completed all steps above successfully and are now at the “Joomla! Installation” page. Joomla! Installer Page

  1. Select your desired language, in my case I'm selecting UK English (en-GB). Then click “Next”.
  2. This next page should inform you of any deficiencies in your Apache/PHP setup. Sadly I don't have the time nor the patience to go into them all here! Google is your friend! Once all except “Display Errors” is in the green, click “Next”.
  3. Click “Next” again to agree to the License!
  4. The next page handles the database integration. Select the Database Type to be mysql. Set the hostname to “localhost”. Set the username and password to correspond with the username and password you set when creating the MySQL database. Set the Database name to “joomla”. Then click “Next”. Joomla DataBase Page
  5. The next page deals with FTP access to your joomla directory. This FTP layer exists only for the joomla installation. Please set your desired FTP Username and password. Then click “Next”.
  6. Nearly there! Now we need to enter the particulars for the site we wish to create. I'll leave these all up to you! The main decision you'll have is whether to install “Sample Data”. This can prove useful in demonstrating alot of Joomla's features however they can prove difficult to remove at times. My advice is to have two separate joomla installs and use one as a live webserver and the other for your personal experimentation. When your ready to continue, click “Next”.

Congratulations! You've successfully completed your install of the Joomla! Content Management System. Take note of the admin username provided and take note of the large red instructions relating to the removal of your “Installation Directory”. It's an easy matter to delete this directory if you are using a FTP client.

To do this last step in your terminal run the following command:

 rm -r joomla/installation/