Joomla!

[http://www.joomla.org/ Joomla!] is an award-winning Content Management System (CMS) that will help you build websites and other powerful online applications.

This guide applies to Ubuntu 6.06 LTS (Dapper Drake)

Installing

Install the LAMP stack

Use [:InstallingSoftware: any method] to install the Apache2, Mysql and Php stack. You will need the following packages:

apache2 php5-mysql libapache2-mod-php5 mysql-server

Set a mysql-root password (not the same as a root password, but a password for mysql)

mysql -u root

mysql> SET PASSWORD FOR 'root'@'localhost' = PASSWORD('yourpassword');

A successful mysql command will show:

Query OK, 0 rows affected (0.00 sec)

Quit the mysql prompt:

mysql> \q

You should now have a functional LAMP stack and a password for the mysql root user.

Visit [:ApacheMySQLPHP:Apache PHP MySQL] for more information on LAMP.

Get the most recent version of Joomla!

Download it from [http://www.joomla.org/content/blogcategory/32/66/ here]. Unpack it and then copy it to your webserver directory.

# Change for new version
SOURCEPKG=Joomla_1.0.12-Stable-Full_Package.tar.bz2
SOURCEWWW=http://joomlacode.org/gf/download/frsrelease/111/264/Joomla_1.0.12-Stable-Full_Package.tar.bz2

# Get it
mkdir joomla
cd joomla
wget $SOURCEWWW

# Unpack it
tar xvjf $SOURCEPKG

# Cleanup
rm -f $SOURCEPKG

# Move
cd ..
sudo mv joomla /var/www/

Handle permissions (choose one option):

# 1. Allow writting in whole joomla subtree
sudo chown -R www-data:www-data /var/www/joomla

# 2. Allow writting only in places Joomla! needs to write to (more secure)
sudo chown -R root:root /var/www/joomla
cd /var/www/joomla
PLACES='
administrator/backups
administrator/components
administrator/modules
administrator/templates
cache
components
images
images/banners
images/stories
language
mambots
mambots/content
mambots/editors
mambots/editors-xtd
mambots/search
media
modules
templates
'
for i in $PLACES; do
    sudo chown -R www-data:www-data $i
done

Joomla needs a database, user and password

You need to create a database. You can do this with PhpMyAdmin or via the command line:

mysqladmin -u root -p create joomla

Where joomla is the name you picked for the mysql database that joomla will use. You can call it anything you want.

mysql -u root -p

mysql> GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER, CREATE TEMPORARY TABLES, LOCK TABLES ON joomla.* TO 'yourusername'@'localhost' IDENTIFIED BY 'yourpassword';

You do not want to have Joomla use the mysql root user to access the database. The above command creates a mysql user (other than the mysql root user) with some priviledges to use the joomla database. You will need to chose the yourusername and yourpassword. If the command was successful, activate the new permissions:

mysql> FLUSH PRIVILEGES;

Quit the mysql prompt:

mysql> \q

Reload Apache2

You may need to force-reload apache2 so that it knows to use the php module if you haven't done so since you installed the LAMP stack.

sudo /etc/init.d/apache2 restart

Finish installation

Point your browser to localhost/joomla, and follow the onscreen instructions.

Pre-installation check

If everything is listed in green, you may proceed.

attachment:screenshot1.jpg

Licence

Joomla! is GPLed.

attachment:screenshot2.jpg

Database configuration

Configure the database name, username and password.

attachment:screenshot3.jpg

Name your site

Give your site a name

attachment:screenshot4.jpg

More site information

Enter site URL and administrator user and password

attachment:screenshot5.jpg

Finish install and remove installation directory

You will be asked to remove the installation directory once configuration is complete.

sudo rm -R /var/www/joomla/installation/

attachment:screenshot6.jpg

Please refer to the [http://help.joomla.org/content/category/15/99/132/ Joomla! installation manual] for more details, specially to [http://help.joomla.org/component/option,com_easyfaq/task,view/id,167/Itemid,268/ Joomla! Administrator's Security Checklist].