Joomla CMS On An ISPConfig Server Within 10 Easy Steps

Want to support HowtoForge? Become a subscriber!
 
Submitted by Hans (Contact Author) (Forums) on Sun, 2006-10-01 13:43. :: ISPConfig | Control Panels

Joomla CMS On An ISPConfig Server Within 10 Easy Steps

joomla

Version 1.2
Author: <hans> [at] bb-hosting [dot] org>
Last edited 14/01/2008

Joomla is a popular Content Management System (CMS).
With this “how to”, I guide you to setup Joomla CMS on your ISPConfig server. Probably you can setup Joomla in different ways but I prefer the way descibed here.
In this how to, I will use just as an example:

- Joomla version 1.0.11.
- I assume also that this is your first Joomla setup for your joomla site, this is not an update!
- Website: www.myjoomlawebsite.tld
- Websitenumber within ISPConfig: web1
- Your webs are stored under /var/www
- MySQL database: web1_db1
- MySQL username: web1_u1
- MySQL password: mysqlpassword
- Administrator (FTP-user) for the website: webadmin

Here we we go:

Step 1 - Create a website:

In ISPConfig, create a website via "New site" in the main menu.
On the tab called "Basis" use www for the hostname and myjoomlawebsite.tld for the domain name. Enable MySQL and PHP scripts for this website but disable PHP Safe Mode.

Step 2 - Create a Administator user for the website:

In ISPConfig, create an Administrator user, so you can upload/download the website later via FTP. For example we will use the loginname "webadmin"for the administrator.
In the main menu select "ISP Manager", select your new website called myjoomlawebsite.tld in the structure tree and press the tab "User and Email". Press "new" and define a new user and its email address. Give this user administrator rights and press "Save".

Step 3 - Create a MySQL database for the website:

Click on the tab called "Options" and create a new database for the website.

ISPConfig will show you:

Database name: web1_db1

Database user: web1_u1

Then you define a password for the database user and press "Save".

Step 4 – Download Joomla to your local desktop:

Download the latest stable Joomla version, which is version 1.0.11 at the moment.
You can download it at:

http://forge.joomla.org/sf/frs/do/viewRelease/projects.joomla/frs.joomla_1_0.1_0_11 by choosing the file Joomla_1.0.11-Stable-Full_Package.zip.

After downloading Joomla, extract it to the file folder of your choice.

Step 5 – Turn off Register Globals Emulation:

In the file folder where you’ve extracted the Joomla files, you’ll find a file globals.php.
Open it with a texteditor and change the line:

define( 'RG_EMULATION', 1 );

into

define( 'RG_EMULATION', 0 );

By changing 1 into 0, globals emulation is turned off, which is recommended for security reasons.

Step 6 – Upload Joomla to your webserver:

Now, you can upload Joomla, using your favourite FTP-client.

URL: ftp://myjoomlawebsite.tld/web
username and password as defined at STEP 2.

Note: you must upload all the Joomla files EXCEPT one file called configuration.php.

Step 7 – Visit your new Joomla site:

Now you can point to your joomla site with your favourite browser.

The (example) address according my how to is: http://myjoomlawebsite.tld

Here you will see the Joomla setup screen:

Picture 1

You will see that under "Recommended Settings Check" everything is green, which means that all is ok.

Picture 2

Step 8 – Setting permissions:

Now we have to make the Joomla directories/files writable for Apache, because at this moment they are not!

Picture 3

To make them writable for Apache, logon to your server as root.
If you use php5 as a module (php5mod) on your ISPConfig server execute the following commands:

cd /var/www/web1/

And make the webspace web writable for Apache:

chown -R -v -f www-data:www-data web/*

ALTERNATIVE:
If you use php5-cgi with suPHP enabled on your ISPConfig server execute the following commands:

cd /var/www/web1/


chown -R -v -f webadmin:web1 web/*

(Remember that "web1" and the username "webadmin" are according my example, use your own webnumber and username instead !)

In your browser and after clicking "Check Again" on the upper right corner of our Joomla setup screen you’ll see that the necessary directories/files are writeable.

Picture 4

If everything looks ok and save, you can click "NEXT" to continue your setup.

STEP 9 - Continue the Joomla Setup:

- Accept the license agreement by clicking "NEXT".

- Fill in the form as shown here:

Picture 5

(Use your own MySQL databasename and MySQL username and MySQL password).
Press "NEXT"to continue.

- Give a name for your new Joomla website and Press "NEXT" to continue.

Picture 6

- Fill in the form as shown here, then press "NEXT"to continue.

Picture 7

- If you read "Congratulations! Joomla is installed. You are done.

Picture 8

DO NOT FORGET THE JOOMLA ADMINISTRATOR USERNAME AND PASSWORD !

- Press "Administrator" in the upper right corner.
You will see this screen, which means we did not remove the installation directory yet.

Picture 9

Step 10 – Remove the Installation directory and visit your Joomla site:

To remove the Joomla installation directory , logon to your server as root.
Navigate to your Joomla web with the command:

cd /var/www/web1/web

(web1 is according my example, use your own webnumber!)

or

cd /var/www/www.myjoomlawebsite.tld/web

After entering the dir command. You’ll see the installation directory called "installation".
You can remove this with the command:

rm –rf installation

In your internet browser you can visit the frontend of your Joomla CMS site by pointing to http://www.myjoomlawebsite.tld.

Picture 10

You can visit the backend at URL http://www.myjoomlawebsite.tld/administrator, login with your Joomla administrator account and start with Joomla.

Picture 11

A final note:
If you run php5-cgi+suPHP for your Joomla site on your ISPConfig server, define the permissions as shown in the picture below. You can do this within Joomla in the main menu under: Site > Global Configuration > Server.


Please do not use the comment function to ask for help! If you need help, please use our forum.
Comments will be published after administrator approval.
Submitted by Desdemonias (not registered) on Wed, 2012-03-07 11:23.

ALTERNATIVE:
If you use php5-cgi with suPHP enabled on your ISPConfig server execute the following commands:

cd /var/www/web1/

chown -R -v -f web1:webadmin web/*

Submitted by Anonymous (not registered) on Thu, 2009-05-14 23:19.

This howto is written for the old Joomla.

I was able to get the new Joomla 1.5 working, using the howtoforge howto with ISPConfig3 on CentOS 5.2:

http://www.howtoforge.com/perfect-server-centos-5.2-ispconfig-3

After you build the CentOS/ISPConfig box, and make sure everything is working (yes, that howto works), you can install Joomla 1.5 on it.

 Download the new Joomla archive file, put it on your website.  I created a directory called 'installation', and unpacked the Joomla archive file in there.

Before you run the installation routine, you have to edit your /etc/php.ini file, and make some changes.

vi /etc/php.ini

register_globals = Off

memory_limit = 128M

session.save_path = "/tmp/"

That's it.  Find the above lines, and change to look like what I listed here.  Reboot the server (probably not necessary, but what the heck), connect your browser to your web site's installation directory, and follow the prompts!  You should be good from there.

 

Submitted by Kayla P. (not registered) on Tue, 2009-09-15 19:25.

Thanks a lot for updating it, that worked perfectly. It's great food for though to see how much with a few changes i can end up totally lost haha. Good thing i found your comment, saved me lots of trouble!

Submitted by reinier (registered user) on Wed, 2006-11-29 22:54.

If you want to use SEF links, you need to comment out the following line in the htaccess.txt

Options FollowSymLinks

Before you rename it to .htaccess!

 (it is noted that on some installation this line can cause problems, apparently my ubuntu Edgy Edge & ISPConfig is such an installation)