Actions

J2.5

Difference between revisions of "Installing Joomla"

From Joomla! Documentation

(created page with screens)
 
m (Hutchy68 moved page Installing Joomla! to J2.5:Installing Joomla!: versioning)
(32 intermediate revisions by 13 users not shown)
Line 1: Line 1:
{{JVer|1.7}}
+
{{version|1.7,2.5}}
 +
=Intro=
 +
=== Hosting requirements ===
  
Installing Joomla! 1.7 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.
  
Before we start installing Joomla! 1.7, there are a couple prerequisites that need to be met to install successfully:
+
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:
 
*Hosting - whether you have a dedicated server, or shared hosting plan, you’ll need some sort of web hosting that meets the following requirements:
**1
+
**PHP v. 5.2+
**2
+
**MySQL 5.04+
**3
+
**Apache 1.3
**4
+
*MySQL Database - you’ll need access to a MySQL database, as well as the following credentials.
**5
+
*MySQL Database - you’ll need access to a MySQL database, as well as the following credentials. Read this tutorial to help set up a database for your Joomla! installation
+
 
**DB Name
 
**DB Name
 
**Host Name
 
**Host Name
 
**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 _____
+
*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! 1.7 - you can find that here.
+
*Latest Release of Joomla! 2.5.X - you can find that here [http://www.joomla.org/download.html Download] .
  
With these requirements met, and resources in place, we are ready to install Joomla!
+
=== Installation ===
  
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.
+
With these requirements met, and resources in place, we are ready to install Joomla
  
Caution - if you unpack the files on your own computer, then copy them to your server, be sure to only move the files contained INSIDE the Joomla! packageIf you transfer the Joomla! folder as well, your site will be accessed at yoursite.com/Joomla instead of yoursite.com
+
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 serverEither way, the Joomla installation needs to be unpacked in the root of your site.
  
With the files moved over to your server, access the Joomla! installation, by simply accessing the domain or directory that the files were moved to (yoursite.com). If all your files are moved correctly, you should see an installation page like this:
+
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=
 +
'''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]]
  
From here, the Joomla! installer makes it very easy to install Joomla! 1.7 The first step is to select your language in the screen above, then press the 'Next' button in the upper right corner.
+
=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.
  
The next step 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]]
  
The third step to installing Joomla! 1.7 is the license.  This is the software license agreement for Joomla! use,a nd simply requires you to press 'Next' in the top right corner after reviewing.
+
=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.
 +
 
 
[[File:J17installscreen5.png|700px]]
 
[[File:J17installscreen5.png|700px]]
  
The Fourth Step is configuring the database connection for Joomla! Here you will need to enter the Hostname, User name, password, and database name for the MySQL database you have set up. An additional option is to change the Table prefix.  This may be helpful for security purposes.  This will alter the names of all the Joomla! tables, by changing the prefix to whatever characters you put there.
+
=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.
  
 
[[File:J17installscreen3.png|700px]]
 
[[File:J17installscreen3.png|700px]]
  
Step Five is the ftp configuration.  This is an optional step for most sites, and typically is not used.  If you would like to enable the ftp layer, simply add your ftp credentials to the options here.
+
=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.
  
 
[[File:J17installscreen6.png|700px]]
 
[[File:J17installscreen6.png|700px]]
  
Step Six, and the last process to install Joomla!, is the site configuration! Here you can add in a site Name, username, password, and email for the administrator, as well as install the Sample Content that can help with starting a new site.
+
=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.
  
 
[[File:J17installscreen7.png|700px]]
 
[[File:J17installscreen7.png|700px]]
  
With that done, Joomla! is now installed!  The last step needed is to remove the installation directory - and the Joomla! installer does this for you as well!  This needs removed for security reasons, to prevent anyone else from coming along and installing Joomla! again over your existing site.  To do this, simple click the "Remove Installation Directory" button.
+
=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.   
 +
Click the '''Remove Installation Directory''' button.
  
 
[[File:J17installscreen10.png|700px]]
 
[[File:J17installscreen10.png|700px]]
[[Category:Joomla! 1.7]]
+
<headertabs/>
 +
[[Category:Installation]]
 +
[[Category:Joomla! 2.5]]

Revision as of 04:21, 15 March 2013

Contents

Intro

Hosting requirements

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

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

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

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

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

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

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

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

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/>