Actions

J3.2

Difference between revisions of "Installing Joomla"

From Joomla! Documentation

m (saving additions, still showing incomplete template, improving still)
m (Hosting Requirements: little alignment adjustment)
(28 intermediate revisions by one user not shown)
Line 1: Line 1:
{{incomplete}}{{RightTOC}}
+
=Requirements=
=== Hosting Requirements ===
+
== Hosting Requirements ==
  
 
Installing Joomla! for the first time is very easy.  Joomla!’s built-in web installer makes setting up your new site a breeze.
 
Installing Joomla! for the first time is very easy.  Joomla!’s built-in web 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 Joomla! successfully. These apply whether you have a dedicated server, a shared hosting plan, or are installing a copy on a local computer for testing or development. You’ll need to meet the following requirements below to install and use Joomla! 3.0 {{JVer|3.0}}
+
Before we start installing Joomla!, there are a couple prerequisites that need to be met to install Joomla! successfully. These apply whether you have a dedicated server, a shared hosting plan, or are installing a copy on a local computer for testing or development.
  
{{#lsth:Technical requirements|Joomla 3.0.x {{JVer{{!}}3.0}}}}
+
You’ll need to meet the following requirements below to install and use Joomla! 3.0 {{JVer|3.0}}
  
=== Downloading and Uploading Joomla! Package Files ===
+
:{{#lsth:Technical requirements|Joomla 3.0.x {{JVer{{!}}3.0}}}}
 +
=== References ===
 +
<references/>
 +
 
 +
=Download=
 +
== Downloading and Uploading Joomla! Package Files ==
  
 
#Download the current release of [http://www.joomla.org/download.html Joomla! 3.0.x]
 
#Download the current release of [http://www.joomla.org/download.html Joomla! 3.0.x]
Line 20: Line 25:
 
{{warning|If you unpack the files on your own computer, then copy them to your server, be sure to move only the folders and files contained '''INSIDE''' the Joomla! package.  If you unpack the folders and files into a folder, for example called, <code>''Joomla''</code> and then upload that folder, your site will have to be accessed at <code>''yoursitename.com/Joomla''</code> instead of <code>''yoursitename.com''</code>.}}
 
{{warning|If you unpack the files on your own computer, then copy them to your server, be sure to move only the folders and files contained '''INSIDE''' the Joomla! package.  If you unpack the folders and files into a folder, for example called, <code>''Joomla''</code> and then upload that folder, your site will have to be accessed at <code>''yoursitename.com/Joomla''</code> instead of <code>''yoursitename.com''</code>.}}
  
 
+
=Start Install=
===<span style="font-size:1.25em;">Installation</span>===
+
=== Main Configuration ===
==== Main Configuration ====
+
 
With the above requirements met, a database created and the required Joomla! files in place, you are ready to install Joomla!. Start the Joomla! web installer by browsing to the site's domain name, <code>''www.yoursitename.com''</code> and you should see:
 
With the above requirements met, a database created and the required Joomla! files in place, you are ready to install Joomla!. Start the Joomla! web installer by browsing to the site's domain name, <code>''www.yoursitename.com''</code> and you should see:
<div style="clear:both; width:auto; display:inline-block;">[[File:J30 Installation screen page 1.png|border|left]]</div>
+
<div style="clear:both; max-width:100%; height:auto; display:inline-block; float:right; margin-left:.3em;">[[File:J30 Installation screen page 1.png|border|left|500px]]</div>
  
 
Joomla! will try to identify the '''Select Language''' field automatically from your browser's language. You can change this if needed.
 
Joomla! will try to identify the '''Select Language''' field automatically from your browser's language. You can change this if needed.
Line 38: Line 42:
 
When everything on the first page is completed, click the '''next button''' to proceed:
 
When everything on the first page is completed, click the '''next button''' to proceed:
  
==== Database Configuration ====
+
=Database Configuration=
<div style="clear:both; width:auto; display:inline-block;">[[File:J30 Installation screen page 2.png|border|left]]</div>
+
=== Database Configuration ===
 +
You will need the information about the database which was suggested above to note.
 +
<div style="clear:both; max-width:100%; height:auto; display:inline-block; float:right; margin-left:.5em;">[[File:J30 Installation screen page 2.png|border|left|500px]]</div>
 +
For simplification, these intructions are a reference to installing with a [[wikipedia:MySQLi|MySQLi]] database. The instructions on the installation page are self explanatory, but here they are again:
 +
* '''Database Type:''' MySQLi is the common database used
 +
* '''Hostname:''' Where is your database located? Common is <code>''localhost''</code>, but some hosts use a specific database server such as <code>''dbserver1.yourhost.com''</code>
 +
* '''Username:''' The username used to connect to the database
 +
* '''Password:''' The password for the database's username
 +
* '''Database Name:''' The name of the database
 +
* '''Table Prefix:''' One is generated automatically, but you can change it. For example, <code>jos3_</code> can be used. Just don't forget to put the underscore character(<code>_</code>) at the end of the prefix.
 +
* '''Old Database Process:''' Should the installer backup or delete existing tables during the installation of new tables? Click, Yes or No to select the choice.
  
 +
All these choices can be edited on the [[Help30:Site_Global_Configuration#Server|Site Global Configuration]] page, under Server options after the installation is completed. Note, you will break your installation if you change these settings after installation unless you have a complete copy of the current database being used by the Joomla! installation. Common uses would be to update the username and password of the database or to complete a move of an existing installation to a new host with different parameters.
  
==== Install Sample Data ====
+
When all the information has been filled in, click the '''next button''' to proceed:
<div style="clear:both; width:auto; display:inline-block;">[[File:J30 Installation screen page 3 top.png|border|left]]</div>
+
  
 +
<div style="clear:both;"></div>
 +
=Finalise=
 +
=== Overview ===
 +
It is now time to finalise the Joomla! installation. The last page of the web brower installation contains all the information about the installation. This includes the options(at the top) for installing sample data and the installation's configurations(at the bottom).
 +
==== Install Sample Data and Email Configurations ====
 +
The first options are for automatically installing sample content to the website and emailing the configuration settings.
 +
<div style="clear:both; max-width:100%; height:auto; display:inline-block; float:right; margin-left:.3em;">[[File:J30 Installation screen page 3 top.png|border|left|500px]]</div>
 +
If you are new to Joomla! it would be benefical to install some '''sample data''' to see how Joomla! works. You can at this time choose to have the configuration settings emailed to you. If the '''Email Configuation''' choice is selected, the '''Email Password''' choice will appear. The email password is off by default for security. You can choose to have the password included, just click Yes.
  
 +
Time to check the configurations of your install and the environment of the installation.
 +
 +
<div style="clear:both;"></div>
 +
=Configuration Check=
 
==== Checking Your Configurations ====
 
==== Checking Your Configurations ====
<div style="clear:both; width:auto; display:inline-block;">[[File:J30 Installation screen page 3 bottom.png|border|left]]</div>
+
If everything is in order, you will see the install at the top of the overview page. If not, this is the place to check and see what may be causing an issue.
 +
<div style="clear:both; max-width:100%; height:auto; display:inline-block; float:right; margin-left:.3em;">[[File:J30 Installation screen page 3 bottom.png|border|left|500px]]</div>
 +
The '''section''' is broken into 4 groups:
 +
*'''Main Configuration:''' All the website specific information, such as the website name, description, admin username, etc.
 +
*'''Database Configuration:''' Contains the information about the database Joomla! will use.
 +
*'''Pre-Installation Check:''' These requirements must all be shown as Yes, otherwise you will not be able to install Joomla! With the exception of the PHP Version, the rest are usually controlled in the [[wikipedia:INI_file|php.ini]]. You may need assistance from your host in correcting these settings or checking to see if it is possible to adjust them. For more information, see [http://php.net/manual/en/configuration.file.php PHP configuration file] file.
 +
*'''Recommended Settings:''' These are settings are recommended in your PHP configuration, but will not prevent Joomla! from being installed. You can refer to the above instructions on how they may be changed.
  
 +
If everything is correct and all checks are passed, you may now click the '''Install''' button in the top right corner of the '''Overview''' page. This will start the actual installation process.
  
==== Success and Finishing Up the Installation ====
+
After you click the '''Install''' button, you should see a progress bar with additional information of the installation. Once the installation completes, you should see the success page!
Joomla! 3 is now installed, but there is one last step to complete. You must delete the '''Installation Folder'''.
+
<div style="clear:both; width:auto; display:inline-block;">[[File:J30 Installation screen page 4.png|border|left]]</div>
+
  
 
+
<div style="clear:both;"></div>
=== References ===
+
=Finishing Up=
<references/>
+
=== Success and Finishing Up the Installation ===
 +
Congratulations! Joomla! 3 is now installed, but there is one last step to complete the installation and start using your Joomla! powered site. You must delete the '''Installation Folder'''. Click on '''Remove Installation folder''' and a success message will appear. Now you can navigate to the '''Administrator''' log in by clicking '''Administrator''' or go right to your site by clicking '''Site'''.
 +
<div align="center" style="max-width:100%; height:auto;">[[File:J30 Installation screen page 4.png|border|700px]]</div>
 +
<headertabs/>
 +
<noinclude>[[Category:Installation]][[Category:Joomla! 3.0]]</noinclude>

Revision as of 11:07, 23 March 2013

[edit]

Hosting Requirements

Installing Joomla! for the first time is very easy. Joomla!’s built-in web 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 Joomla! successfully. These apply whether you have a dedicated server, a shared hosting plan, or are installing a copy on a local computer for testing or development.

You’ll need to meet the following requirements below to install and use Joomla! 3.0 Joomla 3.0

References


Downloading and Uploading Joomla! Package Files

  1. Download the current release of Joomla! 3.0.x
  2. Create a database for use with Joomla! You will need to note basic database information needed when the actual Joomla! installation is started.
    • Location of datase, localhost? Or a specific host's server such as dbserver1.yourhost.com
    • The database name
    • The database user's name
    • The database user's password
  3. Move the downloaded Joomla! installation package to the server. Use a FTP Client to transfer the Joomla! 3.0 files to your server. If you don’t already have an FTP client, we recommend Filezilla
Hint - 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.
Stop hand nuvola.svg.png
Warning!

If you unpack the files on your own computer, then copy them to your server, be sure to move only the folders and files contained INSIDE the Joomla! package. If you unpack the folders and files into a folder, for example called, Joomla and then upload that folder, your site will have to be accessed at yoursitename.com/Joomla instead of yoursitename.com.


Main Configuration

With the above requirements met, a database created and the required Joomla! files in place, you are ready to install Joomla!. Start the Joomla! web installer by browsing to the site's domain name, www.yoursitename.com and you should see:

J30 Installation screen page 1.png

Joomla! will try to identify the Select Language field automatically from your browser's language. You can change this if needed.

Fill in the following information.

  • Site Name: The name of your website — this can be changed at any point later in the Site Global Configuration page.
  • Description: Enter a description of the website. This is a the global fallback meta description used on every page which will be used by search engines. Generally, a maximum of 20 to 25 words is optimal. Again, this can be changed on the Site Global Configuration page at any time. For more on metadata, see Global Metadata Settings and Entering search engine meta-data.
  • Admin Email Address: The admin email address. Enter a valid email in case you forget your password. This is the email address where you'll receive a link to change the admin password.
  • Admin Username: Joomla! uses a default "admin" as the username for the Super User. You can leave it as is, change it now(which a good Security measure) or use My Profile in the Administration interface to change it later.
  • Admin Password: Remember that super user has maximum control of the site (frontend & backend), so try to use a difficult password. Use My Profile in the Administration interface to change it later. Confirm the password in the Confirm Admin Password box.
  • Site Offline: Click the Yes or No box. Yes - this means when installation is complete, your Joomla! website will display the 'Site is offline message' when you browse to yoursitename.com to view the home page. No - this means the site is live when you browse to yoursitename.com to view the home page. You can use the Site Global Configuration in the Administration interface to change the Offline status at any time.

When everything on the first page is completed, click the next button to proceed:

Database Configuration

You will need the information about the database which was suggested above to note.

J30 Installation screen page 2.png

For simplification, these intructions are a reference to installing with a MySQLi database. The instructions on the installation page are self explanatory, but here they are again:

  • Database Type: MySQLi is the common database used
  • Hostname: Where is your database located? Common is localhost, but some hosts use a specific database server such as dbserver1.yourhost.com
  • Username: The username used to connect to the database
  • Password: The password for the database's username
  • Database Name: The name of the database
  • Table Prefix: One is generated automatically, but you can change it. For example, jos3_ can be used. Just don't forget to put the underscore character(_) at the end of the prefix.
  • Old Database Process: Should the installer backup or delete existing tables during the installation of new tables? Click, Yes or No to select the choice.

All these choices can be edited on the Site Global Configuration page, under Server options after the installation is completed. Note, you will break your installation if you change these settings after installation unless you have a complete copy of the current database being used by the Joomla! installation. Common uses would be to update the username and password of the database or to complete a move of an existing installation to a new host with different parameters.

When all the information has been filled in, click the next button to proceed:

Overview

It is now time to finalise the Joomla! installation. The last page of the web brower installation contains all the information about the installation. This includes the options(at the top) for installing sample data and the installation's configurations(at the bottom).

Install Sample Data and Email Configurations

The first options are for automatically installing sample content to the website and emailing the configuration settings.

J30 Installation screen page 3 top.png

If you are new to Joomla! it would be benefical to install some sample data to see how Joomla! works. You can at this time choose to have the configuration settings emailed to you. If the Email Configuation choice is selected, the Email Password choice will appear. The email password is off by default for security. You can choose to have the password included, just click Yes.

Time to check the configurations of your install and the environment of the installation.

Checking Your Configurations

If everything is in order, you will see the install at the top of the overview page. If not, this is the place to check and see what may be causing an issue.

J30 Installation screen page 3 bottom.png

The section is broken into 4 groups:

  • Main Configuration: All the website specific information, such as the website name, description, admin username, etc.
  • Database Configuration: Contains the information about the database Joomla! will use.
  • Pre-Installation Check: These requirements must all be shown as Yes, otherwise you will not be able to install Joomla! With the exception of the PHP Version, the rest are usually controlled in the php.ini. You may need assistance from your host in correcting these settings or checking to see if it is possible to adjust them. For more information, see PHP configuration file file.
  • Recommended Settings: These are settings are recommended in your PHP configuration, but will not prevent Joomla! from being installed. You can refer to the above instructions on how they may be changed.

If everything is correct and all checks are passed, you may now click the Install button in the top right corner of the Overview page. This will start the actual installation process.

After you click the Install button, you should see a progress bar with additional information of the installation. Once the installation completes, you should see the success page!

Success and Finishing Up the Installation

Congratulations! Joomla! 3 is now installed, but there is one last step to complete the installation and start using your Joomla! powered site. You must delete the Installation Folder. Click on Remove Installation folder and a success message will appear. Now you can navigate to the Administrator log in by clicking Administrator or go right to your site by clicking Site.

J30 Installation screen page 4.png