Installation of Joomla! 1.5

You are now ready to install Joomla! 1.5 on your web hosting platform. In this recipe, we will go through the set up of your database and uploading of the files.

This process should only take about five to ten minutes to complete. Once done you will have a working Joomla! site ready to add your own content, templates, extensions, and more.

Most of this process is handled through your browser.

Getting ready

You will need:

  • User name for database
  • Password for database
  • Database server name
  • Site name
  • Email address for Admin of the site
  • Site admin password
  • FTP client (FileZilla or other) and FTP user name and password

How to do it...

  1. Open a browser and point it at your domain or IP address.

    Example: http://www.MyDomain.com

    http://192.168.1.100

    This will trigger your Joomla! installation script to start up. You will see this screen:

    How to do it...

    This is the initial start-up screen for Joomla! 1.5 installation. It defaults to English (US), However Joomla! is available in many languages.

  2. Please choose your language or click Next to accept the default.
  3. Pre-Installation Check
    How to do it...

    This is the Pre-installation Check screen. You should see all green in the top box and mostly or all green in the lower box. Here is a screenshot of the server's setup options close up:

  4. In this case we have Display Errors turned On, it is recommended to be Off.

    A closer look will show you each screen.

    How to do it...

    The Recommended Setting screen is a follows:

    How to do it...

    You should see all green Yes here, if you do not contact your host and tell them to adjust your settings. In our example we have purposely turned On Display Errors. You likely will not see it in your installation. However you should follow the recommended settings for maximum performance.

  5. Once you get all green Yes and your actual settings match the Recommended settings, repeat step one or press this button on top of the screen:
    How to do it...
  6. Should these be set differently, you can change them in a file called php.ini. I recommend you speak to your host about changing them should they be different.

    This will rerun the checks. If however everything is ok, then move to the next step.

  7. License review.
    How to do it...

    This is an information screen showing the GNU/GPL license that applies to your use of Joomla!.

  8. Read the license and click Next.
  9. Database Configuration

    This is the screen you will use to configure your database settings.

    How to do it...
  10. This is a partial screenshot of the database configuration screen. You will need to enter your details in the following screenshot:
    How to do it...

    In this screen you will need the database settings you set up in the previous recipes. You will see two versions of the same setting. One demonstrating GoDaddy.Com® and the other representing cPanel®.

  11. The following screenshots are part of the database configuration screen. The different examples are shown to demonstrate GoDaddy.com® versus cPanel®
    How to do it...
  12. If you are on GoDaddy.com® your installation for basic settings should look like this. Note the Username and the Database Name are the same. And it has a long Host Name. Your Host Name will be different.
    How to do it...
  13. If you are on cPanel® your settings example will look more like this. Note that in most cases localhost will be your Host Name and the username and database name should be different from each other. Again your answers will vary.
  14. Now fill in the Basic Settings screen with the correct responses.
  15. Do not click Next yet.
  16. Database configuration continued.

    Under basic settings you will see Advanced Settings as follows:

    How to do it...

    Assuming this is a new installation, then no action is required on your part.

  17. FTP Layer (THIS STEP IS OPTIONAL AND SHOULD BE SKIPPED IF YOU DO NOT NEED IT)

    On some hosting setups there are various technical reasons why you cannot change permissions or upload extensions that are important to the operation of the site. This layer, while optional most of time is crucial for those hosting setups.

    Contact your host and ask them specifically if they are running 'SuExec'. If so, you can skip this step.

    Tip

    For GoDaddy.com® or Potentiahosting.com you should not need to install this layer and can skip this step.

  18. You will need the following information to complete this setup:
    • FTP User
    • FTP Password
    • FTP Root Path (the directory where your website will reside)
    How to do it...
  19. You can save the FTP password but for security it is recommended you DO NOT.

    To save your password, click Yes under the Advanced Settings.

    Do not change the Host or Port information.

  20. Click Next Step
  21. Main configuration

    This step will personalize your Joomla! installation.

    You should be on this screen:

    How to do it...

    There are only a few steps here.

  22. Fill in your website's Site Name:
    How to do it...

    This will display in the browser and search engines. Don't worry - you can change it anytime.

  23. Next fill in your (admin) email and password. You must type your password in twice.
    How to do it...
  24. Now the next step is optional but recommended as this is to assist you in learning. If you are going to use your site for production, you may wish to skip this step.

    The Install Sample Data will install a lot of menus, content, categories, and sections.

  25. Click the Install Sample Data button:
    How to do it...

    This step only takes a few moments. You will see this upon success:

    How to do it...

    As this is a new installation, and not a migration from Joomla! 1.0 you do not need to install the LOAD MIGRATION SCRIPT.

  26. Click the Next button.
  27. Completion.

    Once you complete the previous step you will be greeted with the following screen:

    How to do it...

    The text in red is giving you final instructions:

    How to do it...

    DO NOT CLOSE THIS SCREEN OR NAVIGATE AWAY.

  28. Now - Open FileZilla and connect to your web server. In the right-hand pane of FileZilla, you should see a screen similar to the following:
    How to do it...
  29. Highlight and right-click the installation folder. You will see the following screen.
    How to do it...
  30. Click Delete for the Installation folder. This will take a few moments. Once done, close FileZilla and return to your Joomla! installation.
  31. Now you can click the Admin button and login:
    How to do it...

    You should see this screen:

    How to do it...
  32. Enter your Username and Password.
  33. This will log you in.
  34. Press Logout.
  35. Close and reopen your browser and open your new website (www.yourdomain.com)
  36. This is how your website should look.
    How to do it...

    This completes the installation and testing of your new setup.

How it works...

This installation program sets up all the necessary parts of the system. It will place all the proper information in the various database tables. It writes out the ever important CONFIGURATION.PHP file which provides the instructions to Joomla! on how to access your database, and a few other important settings.

See also

If you have an older Joomla! 1.0 site, you may wish to migrate it to a 1.5 site. You can learn more about migration from the following URL. Personally I recommend building your new site from scratch to prevent any compatibility problems.

http://docs.joomla.org/Migrating_from_1.0.x_to_1.5_Stable