Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Fetching contributors…

Cannot retrieve contributors at this time

147 lines (95 sloc) 4.453 kb
* @package Joomla.Installation
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
// no direct access
defined('_JEXEC') or die;
First you must have the base environment for Joomla.
We have thoroughly tested Joomla! on: Linux, Free BSD, Mac OS X and Windows.
Linux or one of the BSD's are recommended, but anything else that can run the
a supported PHP version, a supported database and a supported webserver listed
in the Technical Requirements at
should do it.
You MUST ensure that PHP has been compiled with support for MySQL and Zlib
in order to successfully run Joomla.
While we have reports that Joomla! works on IIS server we recommend Apache
for running Joomla! on Windows.
If you want support for SEF (Search Engine Friendly) URLs, you'll need mod_rewrite and the ability to
use local .htaccess files.
1. DOWNLOAD Joomla
You can obtain the latest Joomla! release from:
Copy the tar.gz file into a working directory e.g.
$ cp JoomlaVx.x.x-Stable.tar.gz /tmp/Joomla
Change to the working directory e.g.
$ cd /tmp/Joomla
Extract the files e.g.
$ tar -zxvf JoomlaVx.x.x-Stable.tar.gz
This will extract all Joomla! files and directories. Move the contents
of that directory into a directory within your web server's document
root or your public HTML directory e.g.
$ mv /tmp/Joomla/* /var/www/html
Alternatively if you downloaded the file to your computer and unpacked
it locally use a FTP program to upload all files to your server.
Make sure all PHP, HTML, CSS and JS files are sent in ASCII mode and
image files (GIF, JPG, PNG) in BINARY mode.
Joomla! will currently work with MySQL, MSSQL and PostgreSQL but
the following instructions are for MySQL. Refer to relevant
documentation if you are using another database.
You can use your web control panel or phpMyAdmin to
create a database for Joomla.
Alternatively you can create a database with the CLI.
In the following examples, "db_user" is an example MySQL user
which has the CREATE and GRANT privileges. You will need to use
the appropriate user name for your system.
First, you must create a new database for your Joomla! site e.g.
$ mysqladmin -u db_user -p create Joomla
MySQL will prompt for the 'db_user' database password and then create
the initial database files. Next you must login and set the access
database rights e.g.
$ mysql -u db_user -p
Again, you will be asked for the 'db_user' database password. At the
MySQL prompt, enter following command:
TO nobody@localhost IDENTIFIED BY 'password';
'Joomla' is the name of your database
'nobody@localhost' is the userid of your webserver MySQL account
'password' is the password required to log in as the MySQL user
If successful, MySQL will reply with
Query OK, 0 rows affected
to activate the new permissions you must enter the command
flush privileges;
and then enter 'exit' or 'quit' to exit MySQL.
Finally point your web browser to where the Joomla! web
based installer will guide you through the rest of the installation.
You can now launch your browser and point it to your Joomla! site e.g. -> Main Site -> Admin
You can log into Admin using the username 'admin' along with the
password that was generated or you chose during the web based install.
Upon a new installation, your Joomla website defaults to a very basic
configuration with only a few active components, modules and templates.
Use Admin to install and configure additional extensions, add users, select
default language and much more.
Note that additional community-contributed extensions and languages are
available at the Joomla! Extensions Directory:
You can also install and use the `Install from Web Tab` to access the JED
directly out of the backend here:
Jump to Line
Something went wrong with that request. Please try again.