Compass Designs .net

This Joomla tutorial quickly leads you through installing Joomla Joomla 1.5. It details both a local installation for testing (if you do not have a Joomla hosting account or have a slow internet connection) and a real web server installation.

Joomla Joomla is a complex series of PHP scripts that run on a web server. When you browse a Joomla site, these scripting are being generated on the fly and creating what you see on the pages of the site. The key words here are web server.

Running and Testing Joomla Without a Hosting Account

You cannot download Joomla and try to run it on your computer like an exe file. It has to have a web server, which means you need to have a hosting account. Sounds obvious, but I have had a couple of people if they needed windows XP to run Joomla Joomla!

Now, before we shell out our hard earned money for a hosting account, there is something else you can do first. You can actually run a web server on your local computer, in other words, your desktop or laptop. This is known as having a localhost. It may sound like I just contradicted myself from the previous paragraph, but not quite. You can’t "run" Joomla itself on your own computer, but you can install a localhost web server for it to "run on".

What you need to pull this off is some software that runs Apache, PHP and MySQL on your computer. These are the same software packages that power websites. There are two popular ones, WAMP (www.wampserver.com/en/index.php) and XAMPP (www.apachefriends.org/en/xampp.html) and they are both free (PGL license)

I am going to quickly run through setting up WAMP, not that this package is windows specific.

Download WAMP from the above link, and then install it. It will create a folder c:/wamp/www

Run WAMP, you should get a handy icon in your system tray:

You need the dial to be white to continue. Note if you run Skype, it interferes with WAMP and so you have to start WAMP without Skype running (and then start Skype if you need it)

Now open a browser and go to localhost (no "www")

You should see the following page:

If you are not seeing this then you should stop and figure out why. You have to get this page before you can proceed. The WAMP site has some helpful troubleshooting FAQ's and a forum.

You should see your folder called "Joomla" in the list of Your Projects. Click on that folder and you will get taken to that "website".

Installing a Joomla Site on a Hosting Account

So let's assume you either have a hosting account, or are going to get yourself one. There are some minimum requirements for Joomla to run, and they are slightly different for the different versions.

Here are the minimum requirements for Joomla 1.0

• PHP 4.2.x or above - www.php.net
• MySQL 3.23.x or above - www.mysql.com
• Apache 1.13.19 or above - www.apache.org

You must ensure that you have MySQL, XML and Zlib support built into your PHP.

help.joomla.org/content/view/34/132/

For Joomla 1.5 it’s recommended you have PHP 4.4.3 or above (for enhanced security).

A thread on the Joomla forums lists various hosting companies who are active Joomla community members. The list can be found at forum.joomla.org/index.php/topic,6856.0.html

Note that from now on, the steps are more or less the the same whether you are installing Joomla on a localhost or on a remote web server.

Getting the Joomla Files

This part is easy. Head on over to www.joomla.org and you will see a link to the download section on the home page, it looks like this:

The version number is the number given. This image shows that it's the 11th release in the 1.0 series.

Or you can head straight to the Forge and you will see all possible downloads:

forge.joomla.org/sf/frs/do/viewSummary/projects.joomla/frs

All versions are here as well as various upgrades from one release to another, important if you already have an installation of Joomla.

Important Note:

You cannot upgrade from Joomla 1.0 to Joomla 1.5. There are significant enough changes in the code that simply over writing files would break your site. The developer team has carefully chosen to talk about migration.

"Joomla 1.5 does not provide an upgrade path from earlier versions. Converting an older site to a Joomla 1.5 site requires creation of a new empty site using Joomla 1.5 and then populating the new site with the content from the old site. This migration of content is not a one-to-one process and involves conversions and modifications to the content dump."
dev.joomla.org/component/option,com_jd-wp/Itemid,33/p,107/

This has been a deliberate choice to minimize the number of users who might attempt the "overwrite the files" technique. More can be found in the forum:

"Joomla 1.5 is so significantly changed from 1.0 that there is no 'upgrade' path. This is the reason that we are providing a migration path. The concept is to build a new site and to migrate data from the old site. Extensions need to be installed and configured as if the site is new. The core data migration does reconstruct menu items for core elements and also keeps core module records with configuration settings."
David Gal - forum.joomla.org/index.php/topic,63232.0.html

Unzipping the files

You need to unzip, or unpack the big Joomla files you have onto your server. If you are running as a localhost, your server would be the WAMP directory mentioned above. If you are on a web host, you will need to upload the file and then unpack it. Perhaps the easiest way to do this is with cpanel. Almost all hosting companies provide it. Use your file manager to upload the zip file to public_html (or whatever you have on your host). You can then use file manager to extract the files.

Note:
I don’t recommend using Fantasico. Many hosts provide it but don’t always have the most current file releases.

Installing Joomla through a Web Browser

If you have got this far that means you have unzipped the Joomla package to either a remote web host or your local computer. Now for the fun stuff!

Using your browser of choice (Firefox of course), navigate to the location of all the localhost/Joomla. You will see the first installation screen.

Choose Language:

Here is the first look at some of the internationalization features of Joomla 1.5, you can select amongst many languages for the installation instructions.

Pre-Installation Check

A critical part in the installation process, this checks if all the minimum system requirements are met.

The first set are required minimums, if they are red (not met) then you need to find a new environment (change hosts), talk them into changing their environment (upgrading PHP for example). Note that the last item is a permissions issue on a file that is much easier to rectify. You can usually change permissions through the cpanel provided by your host. This tool is generally an industry standard.

The second set is recommended settings. If you don't meet them you can still install Joomla but it you experience problems with functionality and security.

Once you are green to go, click next.

License

Joomla is released under a GNU/GPL license. One of the most common questions regarding this license is “can I remove the footer link that says Powered by Joomla”. It’s actually perfectly OK to do this, you just have to keep the copyright statement in the source code. However, I would recommend that you keep the link.

Why?

Joomla is an open source project, it receives no funding from any kind of revenue from selling its software. The bottom line is that thousands of developers around the world are developing this software that you are using right now. If you had to buy it from a commercial company, it would cost tens of thousands of dollars, but you are getting it for free. In return, keep the link, it will help the project gain in popularity and grow. Don’t hide the fact that you are using Joomla, be proud of it! And don’t be concerned about any kind of SEO dilution with an extra link off your page. Links to authoritative sites actually help you SEO!

OK, I’ll get off my soapbox now…

Database Configuration

This is one of the main pages of the installation process, it’s where you need to enter important information about the database that your Joomla site will use. Note you will see a drop down for the database type. Joomla 1.5 only really runs on SQL, but some of the foundation has been laid for the next release, 2.0, to use more types, for example Oracle.

The hostname will almost always be “localhost”

The Username and password will have been provided by your hosting company, usually in an email you got when you created the account.

If you are installing on a localhost using WAMP or XAMPP, the Username is usually “root” and the password is nothing/blank.

Once you have entered this information, click Get Privileges and the Joomla installer checks to see if that user has rights to create a database. You should see this message:

If you made an error, or the user does not have sufficient permissions, then you get this message (after a small delay):

If the user you have does not have permissions then you can ask your hoster to pre-create a SQL database for you to use.

Available collations refer to various character sets available for different languages. When you click the button you get a list of what is available:

Pick a Database name for the SQL database that Joomla will use. Use some sort of name that is not confusing. Other scripts use SQL databases and before you know it you might have several on your server and will need to tell them apart. Don’t use spaces in the name.

If you are running several Joomla sites but only have access to one database, you will need to use a table prefix to distinguish them. You’ll need to enter the prefix in the advanced settings (below)

Note if your user did not have database creation privileges and you were provided with a database instead you would obviously put that in as the name.

The advanced settings are concerned with what content the site starts with and also the table prefixes mentioned above.

If you have an existing site and you are reinstalling over the top, you will need to select Drop Existing Tables. If you need to keep a back of them, select Backup Old Tables. Using “jos” as a table prefix is conventional unless you have multiple sites in the same database.

Main Configuration

The Main Configuration page determines how you will insert content into your site. You have three choices:

• Install Sample Data
  This installs the default Joomla content that you have probably seen all over the web with “Welcome to Joomla”. Note that is also includes all the menus, navigation links and sections/categories. If you are learning how to use Joomla this is highly recommended. Its easier to adapt and revise than to start from scratch.
• Load SQL script
  This is a SQL file that might have a customized set of content
• Migration from previous versions
  This is a special function that is part of a process to migrate a Joomla site running on 1.0 to 1.5 and requires a special component to do so. This is discussed more in the Appendix.

Give your site a name (pay attention to SEO keywords) and then enter the super administration information. This will be the first user in the site and automatically gets that status. Note that if you don’t change the password, it will use the one shown on the left. Make sure you write it down!

Cross your eyes, close your fingers and click next. Hopefully you will see this screen

If you do get this result, you can investigate different language options, view the site or jump right to the administration of your site.

If you don’t get this page, then you have some work to do. Often issues arise because of server environments. If the solution is not obvious, a useful step is to copy the error message or the main part of it and then search for it both on the Joomla help forums, forum.joomla.org and in Google. The chances are if you get an error, someone else has before you.

Need some help with Joomla 1.5?

Head over to the forum.joomla.org/index.php/board,304.0.html

Comments (35)

Show/hide comments

Brian Carr said:

Another choice I like that you have supplied this information for people to find out how they can use Joomla from home. You have detailed 2 very easy ways to do just that without having to purchase a URL and hosting services. There is one other way that you might want to mention and that is running a real webserver at home using dynamic DNS services that are built into most routers these days. I have found that most people have a spare or old computer laying around doing nothing but collecting dust in a closet. Many of these are even Pentium class computers that are easily capable to running a basic webserver. Ubuntu even has a setup just for this that is very easy to setup and use. But any Linux flavor will work. Perhaps you could add a short tutorial using one of the newbie friendly Linux distros for those that do have the extra equipment. Just a thought and thanks for yet another great tutorial.

September 18, 2006

Barrie North said:

I might have to pass Linux is definately not my strength, I don't think I could do a decent job on that one!

September 20, 2006

Just Me said:

... You (or ya'll) are SO my heroes! Joomla has intimidated me. I didn't want to run it off my web host for fear of messing up a business site and had no idea to run it locally. Thanks so much for holding my hand. The karma gods love you.

October 01, 2006

dj said:

... How about documenting an upgrade path for those folks who have already installed a previous version? Nothing like a mixed release.

October 11, 2006

admin said:

Great Idea I will have to do that. Its not an upgrade but a migration and involved a custom free component (I think). I'll have to make sure this gets into my book.

October 11, 2006

Hernan said:

Run Jommla on OS X For those wanting to run it on OSX, you can use MAMP, which is the alternative to WAMP for the mac. http://www.mamp.info/en/home/ You can easily install it on you apps folder (no messing with your OSX default PHP, Apache and MySQL) and lunch the server with a widget. Drop the Joomla folder in the htdocs directory: That is ~/Applications/MAMP/htdocs/ Neat.

October 20, 2006

Christian Sweningsen said:

Are you using it? I've heard every imaginable notion about whether 1.5 is stable enough for a "production" site -- with many caveats that it is, after all, Beta. Are you running this site with it? Thanks for the tutorial, Christian Sweningsen NewScience Alliance An active-networking resource community for qualitative, phenomena-based science education

November 16, 2006

Spencer said:

... Thanks for the info, do you know how to install templates in 1.5? It don't see the option so I am wondering if that is enable yet... Thanks!

December 28, 2006

Administrator said:

... @Christian I think 1.5 is pretty stable right now, just in the last process of bug fixing. A greater issue is the speed with which 3rd party developers get their extensions to work with 1.5

December 28, 2006

Eike J Heinze said:

... Hi; Without your tutorial I would still be lost, Thanks a bunch! Just posted this in Jommla! install forum; maybe you are interested? http://forum.joomla.org/index.php/topic,158802.0.html#new TIA Eike

April 10, 2007

Nilpo said:

... XAMPP is a great solution for getting Apache/PHP/MySQL up and running in Windows, but if you're intending on running Joomla you should try the Joomla Stand Alone Server which does the same thing and also installs Joomla for you. You can find it here: http://jsas.joomlasolutions.com/

April 30, 2007

Yong Hwee said:

... I'm gonna use MAMP on my mac to try Joomla! Anyway, are there ways to get Joomla! up and running without a web server? Will something like Headdress allow me to implement virtual hosting on my mac?

May 17, 2007

David Lo Pan said:

... Nicely done tutorial. Given that this site is for "absolute beginners" and seems to feature WAMP for those interested in developing the site locally, might I suggest a couple little things. I know this is dumb, and you may have even discussed it, however, you might want to mention that you need to add the Joomla folder into your local host root directory in order to launch the install from your "localhost" page. You might also want to include a little blurb about how to create a new MySQL database for the installation. Other than those minor criticisms, great job man.

August 07, 2007 | url

ksnaas said:

... You suffer from some problems in the installation but after reading this issue has been solved most of these problems thanks bro

October 08, 2007 | url

jasmine1 said:

... Can we use the WAMP server without having internet connection?

October 12, 2007

admin said:

... @Jasmine That's exactly the point of WAMP5, yes. You don't need a hosting account or connection.

October 12, 2007

barcapatx said:

... Just had to say well done on a great tutorial. I installed WAMP and Joomla 1.5 onto my pc in about 30 minutes, all works first time! Awesome. Would have been even quicker but the unzip of the Joomla15 files took about 10 mins for some reason, think its a problem with my vista install, not the zip. Last night I setup Joomla 1.5 on my web host account, that was also pretty fast - about 2 hrs. Biggest delays there were ftp'ing the zip file up to my web host account, which took about 45 mins, and creating new db/db users etc.

October 25, 2007

jsoftj said:

... That's exactly the point of WAMP5, yes. You don't need a hosting account or connection. Very nice Thanks

November 15, 2007 | url

ghannam said:

... Can we use the WAMP server without having internet connection

December 31, 2007 | url

nabeel said:

... Thanks man Will be used here soon www.jeelsoft.com

January 08, 2008 | url

Wendy Tefft said:

... Thanks! My cpanel/fantastico only offers 1.o, this was very helpful.

June 07, 2008

randy Garbin said:

... I don't see anything here about installing Joomla on a Mac using its built in web server. I've enabled personal web sharing. I've installed MySQL and got it running. I've created a new database. But I can't get Joomla to talk to the database. What am I doing wrong. OS X 10.4.11.

June 12, 2008 | url

rbc303 said:

... How can I run a Joomla test site on the same server that I am running my live static site? THEN, when it is all nice and pretty, move it Live? I would like the least painless way possible!! Can't find my exact situation on the Joomla forums.

June 19, 2008

noura azeez said:

... Thanks for help , just a little note : The hostname is not always to be “localhost” some hosting companies may put Mysql server on another server user must ask for server name or IP .

July 27, 2008 | url

ashish said:

... heloo i am facing a problem while installing joomla 1.5.6 version.On the database setting page i entered the values and after clicking next it says"Unable to connect to the database:Could not connect to MySQL" .Plz tell me what to do.Also i am not sure to enter what values for username and password.

August 30, 2008

Yonke said:

... I want to install Joomla 1.5 on my localhost but the installer says I cannot as the cookies is disable or problem with server's session.save_path. How to resolve this? The browser cookies is enable already. Thanks.

September 28, 2008

microlinc said:

... I am trying to install Joomla 1.57 using WAMP. I am following the instructions but the database installation seems very different to the one shown in the tutorial. Do I need to create the mysql database first, if so could someone please tell me how to do it and where it should live. Thanks in advance.

September 29, 2008

terrafovea said:

... Erhhh...Is it just me or did you totally skip over the FTP info screen? The bummer of it is THAT'S where my problem seems to lay. Or Lie. Whichever. The setup won't accept my FTP information, I figure that would be a pretty straightforward thing. Everything else runs smoothly, and I'm allowed to hit "next" and skip over that area, but when I get to the admin page after deleting the installation directory, my login and password don't work. I'm TOTALLY server ignorant, or pretty durnned close. I could REALLY use dome help!

October 03, 2008 | url

fish_Gina said:

... This is real good artical.I've installed joomla and virtuemart 4 months ago. At that time there is not so detail tutorial. I spent a lot of time to understand the structure of joomla . and the step to install. In fact i want to write the same artical for my repport. Yours is very good. Thanks.

October 15, 2008

moapz said:

... in WAMP page, in section " Your Projects" , it's empty ! why ? >>>> but your tutorial ...

October 23, 2008

Traveller said:

... I would like to suggest another alternative, one I have used to run Joomla on my laptop for learning purposes. Although it sounds esoteric, it's actually quite easy to do, and that is to install and use a virtual machine to run Joomla, in my case, run it on my laptop computer. There is no cost, the software is all free. The advantage is that installation of Joomla as a "virtual appliance" becomes a breeze. What is a virtual machine? It is a complete virtual computer that runs inside your actual physical computer. This virtual computer has its own hard drive and other hardware, its own operating system, its own applications and is completely segregated from your physical machine. Think of it as the virtual world that existed in the movie "The Matrix". For example, I can run Linux on my virtual machine, which is installed on my Windows XP laptop. The virtual machine does not know that that it is virtual, and is unaware of the physical host machine. The virtual machine is capable of using the host machine's network connection, so the internet is available to virtual machines. How to install? Go to www.vmware.com and download and install the "VMWare Player" Then go to the "Virtual Appliances" area of vmware.com and download "JumpBox for Joomla 1.5.7" and run it on the VMWare Player. I am not a super techie, and managed to do the above quite easily. It is a straightforward process. You'll notice there are hundreds of these "vitual appliances" on the VMWare site. Want to try out Ubuntu Linux on your windows machine but don't want to repartition your drive and do other invasive things on your computer? VMWare is the answer! It leaves your physical computer untouched, since all virtual appliances look like just another application as far as your host (physical) computer is concerned. Have fun! I hope people find this useful.

November 18, 2008

Traveller said:

... And just to be clear on the above post, installing Joomla this way means you don't have to worry about installing PHP, Apache, MySQL or anything else! All that has already been done in the virtual appliance, which is ready to go. All you have to do is push the "Play" button on the VMWare player.

November 18, 2008

Dateson said:

... I'm using xampp because I'm working on ubuntu linux, and it is working very slow.

November 26, 2008 | url

7be said:

... Can we use the WAMP server without having internet connection?

January 02, 2009 | url

شات said:

... and I would like to suggest another alternative, one I have used to run Joomla on my laptop for learning purposes. Although it sounds esoteric, it's actually quite easy to do, and that is to install and use a virtual machine to run Joomla, in my case, run it on my laptop computer. There is no cost, the software is all free.

January 02, 2009 | url

Show/hide comment form