Archived

Difference between revisions of "Installing Joomla"

From Joomla! Documentation

m (format date)
m (version is redundant, namespace with icon tagging, will have to rewrite some version tags to use namespacing)
(9 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{JVer|1.7}}{{JVer|2.5}}
+
=Intro=
 
 
== Installing Joomla ==
 
 
 
 
=== Hosting requirements ===
 
=== Hosting requirements ===
 
 
Installing Joomla! for the first time is very easy.  Joomla!’s built-in installer makes setting up your new site a breeze.
 
Installing Joomla! for the first time is very easy.  Joomla!’s built-in installer makes setting up your new site a breeze.
  
Line 18: Line 14:
 
**Username
 
**Username
 
**Password
 
**Password
*FTP Client - for transferring files to your server.  If you don’t already have an FTP client that you use, we recommend [http://filezilla-project.org/download.php?type=client Filezilla]
+
*FTP Client - for transferring files to your server.  If you don’t already have an FTP client that you use, we recommend [http://filezilla-project.org/download.php?type=client Filezilla] (ensure transfers are set to Binary)
 
*Latest Release of Joomla! 2.5.X - you can find that here [http://www.joomla.org/download.html Download] .
 
*Latest Release of Joomla! 2.5.X - you can find that here [http://www.joomla.org/download.html Download] .
  
Line 32: Line 28:
 
With the files transferred to your server, access the Joomla installation through your web browser by entering the address of your site, for example ''http://www.example.com''.
 
With the files transferred to your server, access the Joomla installation through your web browser by entering the address of your site, for example ''http://www.example.com''.
  
 +
=Step 1=
 
'''Step 1''' is to select your language in the screen above, then press the 'Next' button in the upper right corner.
 
'''Step 1''' is to select your language in the screen above, then press the 'Next' button in the upper right corner.
  
 
[[File:J17installscreen1.png|700px]]
 
[[File:J17installscreen1.png|700px]]
  
 +
=Step 2=
 
'''Step 2''' runs a series of system and server checks to ensure that Joomla will be able to install, and function correctly.  The top section of items should all be green and 'Yes'.  If any are not (they'll be red and say "No") then you will need to take action to correct them.  The bottom section of items are not required, but are recommended to ensure that Joomla can operate smoothly.
 
'''Step 2''' runs a series of system and server checks to ensure that Joomla will be able to install, and function correctly.  The top section of items should all be green and 'Yes'.  If any are not (they'll be red and say "No") then you will need to take action to correct them.  The bottom section of items are not required, but are recommended to ensure that Joomla can operate smoothly.
  
 
[[File:J17installscreen2.png|700px]]
 
[[File:J17installscreen2.png|700px]]
  
 +
=Step 3=
 
'''Step 3''' is to review the GNU license.  This is the software license agreement for Joomla use, and simply requires you to press 'Next' in the top right corner after reviewing.
 
'''Step 3''' is to review the GNU license.  This is the software license agreement for Joomla use, and simply requires you to press 'Next' in the top right corner after reviewing.
  
 
[[File:J17installscreen5.png|700px]]
 
[[File:J17installscreen5.png|700px]]
  
 +
=Step 4=
 
'''Step 4''' is configuring the database connection for Joomla.  Here you will need to enter the Database type, Hostname, User name, Database name and the Database prefix for the MySQL database you have set up. If your settings are not correct, you might be [[unable to connect to the database]]. An additional option is to change the Table prefix. (Note: Joomla 2.5.x now offers a random default prefix)  This may be helpful for security purposes.
 
'''Step 4''' is configuring the database connection for Joomla.  Here you will need to enter the Database type, Hostname, User name, Database name and the Database prefix for the MySQL database you have set up. If your settings are not correct, you might be [[unable to connect to the database]]. An additional option is to change the Table prefix. (Note: Joomla 2.5.x now offers a random default prefix)  This may be helpful for security purposes.
  
 
[[File:J17installscreen3.png|700px]]
 
[[File:J17installscreen3.png|700px]]
  
 +
=Step 5=
 
'''Step 5''' is the FTP Configuration.  This step is unnecessary for most sites and its need is usually identified if you find you cannot upload media or images or install Extensions. The details can be added at a later time directly within the '''Global Configuration''' in the Joomla Administration pages.  This step is '''not''' required on servers installed on a Windows operating system.
 
'''Step 5''' is the FTP Configuration.  This step is unnecessary for most sites and its need is usually identified if you find you cannot upload media or images or install Extensions. The details can be added at a later time directly within the '''Global Configuration''' in the Joomla Administration pages.  This step is '''not''' required on servers installed on a Windows operating system.
  
 
[[File:J17installscreen6.png|700px]]
 
[[File:J17installscreen6.png|700px]]
  
 +
=Step 6=
 
'''Step 6''', and the last to installing Joomla, is the '''Site Configuration'''.  Here you must add a '''Site Name''', '''Admin User Name''', '''Admin Password''', and '''Admin e-mail address'''. If you are new to Joomla you should also CLICK '''Install the Sample Content''', this will help with learning about Joomla.
 
'''Step 6''', and the last to installing Joomla, is the '''Site Configuration'''.  Here you must add a '''Site Name''', '''Admin User Name''', '''Admin Password''', and '''Admin e-mail address'''. If you are new to Joomla you should also CLICK '''Install the Sample Content''', this will help with learning about Joomla.
  
[[File:J17installscreen7.png|link=http://www.1-referencement.com|700px]]
+
[[File:J17installscreen7.png|700px]]
  
 +
=Step 7=
 
'''Step 7''' Is the final step. Joomla is now installed!  You must now remove the installation directory, this needs to be removed for security reasons to prevent anyone else from coming along and reinstalling Joomla over your existing site.   
 
'''Step 7''' Is the final step. Joomla is now installed!  You must now remove the installation directory, this needs to be removed for security reasons to prevent anyone else from coming along and reinstalling Joomla over your existing site.   
 
Click the '''Remove Installation Directory''' button.
 
Click the '''Remove Installation Directory''' button.
  
 
[[File:J17installscreen10.png|700px]]
 
[[File:J17installscreen10.png|700px]]
 
+
<headertabs/>
 
[[Category:Installation]]
 
[[Category:Installation]]
 
[[Category:Joomla! 2.5]]
 
[[Category:Joomla! 2.5]]

Revision as of 08:05, 29 April 2013

This page has been archived. This page contains information for an unsupported Joomla! version or is no longer relevant. It exists only as a historical reference, it will not be improved and its content may be incomplete and/or contain broken links.

Intro[edit]

Hosting requirements[edit]

Installing Joomla! for the first time is very easy. Joomla!’s built-in installer makes setting up your new site a breeze.

Before we start installing Joomla!, there are a couple prerequisites that need to be met to install successfully:

  • Hosting - whether you have a dedicated server, or shared hosting plan, you’ll need some sort of web hosting that meets the following requirements:
    • PHP v. 5.2+
    • MySQL 5.04+
    • Apache 1.3
  • MySQL Database - you’ll need access to a MySQL database, as well as the following credentials.
    • DB Name
    • Host Name
    • Username
    • Password
  • FTP Client - for transferring files to your server. If you don’t already have an FTP client that you use, we recommend Filezilla (ensure transfers are set to Binary)
  • Latest Release of Joomla! 2.5.X - you can find that here Download .

Installation[edit]

With these requirements met, and resources in place, we are ready to install Joomla

To begin our installation, we’ll first need to move our Joomla installation package to the server. This can be accomplished by simply moving the downloaded package to your server, then unpacking it. Or you can unpack the files on your local computer, then move the Joomla installation over to your server. Either way, the Joomla installation needs to be unpacked in the root of your site.

Caution - if you unpack the files on your own computer, then copy them to your server, be sure to move only the files contained INSIDE the Joomla package. If you transfer the Joomla folder as well, your site will be accessed at yoursite.com/Joomla instead of yoursite.com.

The Joomla installer now makes it very easy to install Joomla. With the files transferred to your server, access the Joomla installation through your web browser by entering the address of your site, for example http://www.example.com.

Step 1[edit]

Step 1 is to select your language in the screen above, then press the 'Next' button in the upper right corner.

J17installscreen1.png

Step 2[edit]

Step 2 runs a series of system and server checks to ensure that Joomla will be able to install, and function correctly. The top section of items should all be green and 'Yes'. If any are not (they'll be red and say "No") then you will need to take action to correct them. The bottom section of items are not required, but are recommended to ensure that Joomla can operate smoothly.

J17installscreen2.png

Step 3[edit]

Step 3 is to review the GNU license. This is the software license agreement for Joomla use, and simply requires you to press 'Next' in the top right corner after reviewing.

J17installscreen5.png

Step 4[edit]

Step 4 is configuring the database connection for Joomla. Here you will need to enter the Database type, Hostname, User name, Database name and the Database prefix for the MySQL database you have set up. If your settings are not correct, you might be unable to connect to the database. An additional option is to change the Table prefix. (Note: Joomla 2.5.x now offers a random default prefix) This may be helpful for security purposes.

J17installscreen3.png

Step 5[edit]

Step 5 is the FTP Configuration. This step is unnecessary for most sites and its need is usually identified if you find you cannot upload media or images or install Extensions. The details can be added at a later time directly within the Global Configuration in the Joomla Administration pages. This step is not required on servers installed on a Windows operating system.

J17installscreen6.png

Step 6[edit]

Step 6, and the last to installing Joomla, is the Site Configuration. Here you must add a Site Name, Admin User Name, Admin Password, and Admin e-mail address. If you are new to Joomla you should also CLICK Install the Sample Content, this will help with learning about Joomla.

J17installscreen7.png

Step 7[edit]

Step 7 Is the final step. Joomla is now installed! You must now remove the installation directory, this needs to be removed for security reasons to prevent anyone else from coming along and reinstalling Joomla over your existing site. Click the Remove Installation Directory button.

J17installscreen10.png <headertabs/>