Actions

Difference between revisions of "Installer"

From Joomla! Documentation

(Using the the Joomla! Installer)
m (Using the the Joomla! Installer)
(17 intermediate revisions by 2 users not shown)
Line 4: Line 4:
 
Once your files have been uploaded to the hosting space using an [[Using_an_FTP_client_to_upload_files|FTP client]], it is time to install Joomla!.   
 
Once your files have been uploaded to the hosting space using an [[Using_an_FTP_client_to_upload_files|FTP client]], it is time to install Joomla!.   
  
First open an Internet Browser and type in the address of your Joomla! installation directory.  For example:
+
First open an Internet Browser and type in the address of your new Joomla! website.  For example:
  
<source lang="html4strict">yourdomain.com/joomlainstallationdirectory</source> or if you are running from your local server, type:
+
<source lang="html4strict">yourdomain.com</source> or if you are running from your local server, type:
<source lang="html4strict"> http://localhost/name of your joomla site/installation/index.php </source>
+
<source lang="html4strict"> http://localhost/name-of-your-joomla-site </source>
  
  
Line 17: Line 17:
  
 
'''Screen 2:'''
 
'''Screen 2:'''
Click 'Next' and Joomla! displays the Pre-Installation Checklist.  Specific details relating to PHP settings are outlined here.  To proceed with the installation, all the lights should be green.
+
Click 'Next' and Joomla! displays the Pre-Installation Checklist.  Specific details relating to PHP settings are outlined here.  To proceed with the installation, all the lights should be green and set to Yes.
  
 
[[Image:Installer_PreCheck.jpg]]
 
[[Image:Installer_PreCheck.jpg]]
Line 24: Line 24:
  
 
*PHP version must be 4.3.10 or greater than 4.3.10
 
*PHP version must be 4.3.10 or greater than 4.3.10
**Must be set to YES
+
*Zlib Compression Support 
**Your webserver's PHP version must be over 4.3.10
+
 
+
*Compression support for zlib
+
 
*XML support
 
*XML support
 
*MySQL support   
 
*MySQL support   
*Directive MB string language by default  
+
*MB Language is Default  
*Directive MB string overload deactivated  
+
*MB String Overload Off  
*Modifiable configuration.php file
+
*Writable configuration.php  
**Create a file named configuration.php on root or rename the default one from the package(configuration.php-dist)
+
  
*Safe Mode
+
'''Recommended settings for the actual column:'''
*Display Errors
+
 
*File Transfer
+
*Safe Mode is off
*Magic Quotes Runtime
+
*Display Errors is on
*Register Globals
+
*File Uploads is on
*Output Buffering
+
*Magic Quotes Runtime is off
*Session autostart
+
*Register Globals is off
 +
*Output Buffering is off
 +
*Session Auto Start is off
  
  
Line 51: Line 49:
  
 
'''Screen 4:'''
 
'''Screen 4:'''
Click 'Next' to enter the Database specifics.  Guidelines are provided on the right-hand side to assist in completing the text fields properly.  Please note that all data must be entered correctly to avoid errors.
+
Click 'Next' to enter the Database configurations.  Guidelines are provided on the right-hand side to assist in completing the text fields properly.  Please note that all data must be entered correctly to avoid errors. The fields to fill are:
 +
*Host name:
 +
*Username:
 +
*Password:
 +
*Database name:
  
[[Image:Installer_FTP.jpg]]
+
Note that you need to create a database.  This can be done through your MySQL manager in your webhost or through the default phpMyAdmin application on  WAMP(Windows, Apache, MySQL, PHP) server application.  Databases created through your web host usually take 15-20 minutes to set up so it is best so set them up while you are transferring files to your server rather than waiting until this step.
 +
 
 +
[[Image:Installer_Database.jpg]]
  
  
 
'''Screen 5:'''
 
'''Screen 5:'''
Click 'Next' to enter the FTP settings.  This allows Joomla! to operate in a more secure way, eliminating the need for PHP to handle file upload requests.  Note: The FTP layer is not necessary on Windows servers.
+
Click 'Next' to enter the FTP settings.  This allows Joomla! to operate in a more secure way, eliminating the need for PHP to handle file upload requests.  Note: The FTP layer is not necessary but advised for additional site security.
  
 
[[Image:Installer_FTP.jpg]]
 
[[Image:Installer_FTP.jpg]]
Line 63: Line 67:
  
 
'''Screen 6:'''
 
'''Screen 6:'''
Click 'Next' to enter the Main Configuration details.
+
Click 'Next' to enter the Main Configuration details. Here you fill in
 +
*Site name:
 +
*Your E-mail:
 +
*Admin password:
 +
*Confirm admin password:
 +
 
 +
Notice: To install sample data (modules, articles, sections, categories) you can press the install sample data button before you click the next step.  This will give you a functional Joomla! site with pre-populated content to work from.  
  
 
[[Image:Installer_MainConfig.jpg]]
 
[[Image:Installer_MainConfig.jpg]]

Revision as of 03:10, 2 August 2012

Copyedit.png
This Article Needs Your Help

This article is tagged because it NEEDS REVIEW. You can help the Joomla! Documentation Wiki by contributing to it.
More pages that need help similar to this one are here. NOTE-If you feel the need is satistified, please remove this notice.


Using the the Joomla! Installer

Once your files have been uploaded to the hosting space using an FTP client, it is time to install Joomla!.

First open an Internet Browser and type in the address of your new Joomla! website. For example:

yourdomain.com

or if you are running from your local server, type:

 http://localhost/name-of-your-joomla-site


Screen 1: After the correct address is entered, the image below will appear. Joomla! has redirected you to the /installation subdirectory. In this step you can choose the default language (English) or anyother one.

Installer Lang.jpg


Screen 2: Click 'Next' and Joomla! displays the Pre-Installation Checklist. Specific details relating to PHP settings are outlined here. To proceed with the installation, all the lights should be green and set to Yes.

Installer PreCheck.jpg

Explanation about terms: (TECHNICAL REVIEW NEEDED OF THIS EXPLANATION)

  • PHP version must be 4.3.10 or greater than 4.3.10
  • Zlib Compression Support
  • XML support
  • MySQL support
  • MB Language is Default
  • MB String Overload Off
  • Writable configuration.php

Recommended settings for the actual column:

  • Safe Mode is off
  • Display Errors is on
  • File Uploads is on
  • Magic Quotes Runtime is off
  • Register Globals is off
  • Output Buffering is off
  • Session Auto Start is off


Screen 3: Click 'Next' and the licence prompt below will appear.GNU/GPL

Installer GNUGPL.jpg


Screen 4: Click 'Next' to enter the Database configurations. Guidelines are provided on the right-hand side to assist in completing the text fields properly. Please note that all data must be entered correctly to avoid errors. The fields to fill are:

  • Host name:
  • Username:
  • Password:
  • Database name:

Note that you need to create a database. This can be done through your MySQL manager in your webhost or through the default phpMyAdmin application on WAMP(Windows, Apache, MySQL, PHP) server application. Databases created through your web host usually take 15-20 minutes to set up so it is best so set them up while you are transferring files to your server rather than waiting until this step.

Installer Database.jpg


Screen 5: Click 'Next' to enter the FTP settings. This allows Joomla! to operate in a more secure way, eliminating the need for PHP to handle file upload requests. Note: The FTP layer is not necessary but advised for additional site security.

Installer FTP.jpg


Screen 6: Click 'Next' to enter the Main Configuration details. Here you fill in

  • Site name:
  • Your E-mail:
  • Admin password:
  • Confirm admin password:

Notice: To install sample data (modules, articles, sections, categories) you can press the install sample data button before you click the next step. This will give you a functional Joomla! site with pre-populated content to work from.

Installer MainConfig.jpg


Screen 7: Click 'Next' and a warning to delete the installation directory will appear. Once that is done (most likely using FTP client, click either the 'View Site' tab or the 'Administrator' tab to continue using Joomla!.