# @copyright  (C) 2005 Open Source Matters, Inc. <https://www.joomla.org>
# @license    GNU General Public License version 2 or later; see LICENSE.txt


REQUIREMENTS
------------

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 BSDs are recommended, but anything else that can run
a supported PHP version, a supported database and a supported web server listed
in the Technical Requirements at https://downloads.joomla.org/technical-requirements
should do it.


SERVER CONFIGURATION
--------------------

You MUST ensure that PHP has been compiled with support for MySQL (or the database
you are using) 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.


OPTIONAL COMPONENTS
-------------------

If you want support for SEF (Search Engine Friendly) URLs using the Apache web server
you'll need mod_rewrite and the ability to use local .htaccess files. If you are using
the IIS web server you'll need the ability to use local web.config.txt files


INSTALLATION
------------

1. DOWNLOAD Joomla

	You can obtain the latest Joomla! release from:
		https://downloads.joomla.org/latest

	Copy the tar.gz file into a working directory eg

	$ cp JoomlaVx.x.x-Stable.tar.gz /tmp/Joomla

	Change to the working directory eg

	$ cd /tmp/Joomla

	Extract the files eg

	$ tar -zxvf JoomlaVx.x.x-Stable.tar.gz

	This will extract all the 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 eg

	$ mv /tmp/Joomla/* /var/www/html

	Alternatively if you downloaded the file to your computer and unpacked
	it locally use an 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.


2. CREATE THE Joomla! DATABASE

	Joomla! will currently work with MySQL and PostgreSQL but
	the following instructions are for MySQL. Refer to the 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 username for your system.

	First, you must create a new database for your Joomla! site eg

	$ 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 eg

	$ mysql -u db_user -p

	Again, you will be asked for the 'db_user' database password.  At the
	MySQL prompt, enter following command:

	GRANT ALL PRIVILEGES ON Joomla.*
		TO nobody@localhost IDENTIFIED BY 'password';

	where:

	'Joomla' is the name of your database
	'nobody@localhost' is the userid of your web server 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.

3. INSTALLATION
	The main method of installation is via the web browser. You can start that
	installation by simply pointing your web browser to http://www.example.org
	where the Joomla! web based installer will guide you through the rest of
	the installation.

	An alternative method of installation is from the command line. On the command line of your
	server, in the root folder of Joomla, you can run the following command

		php installation/joomla.php install

	You will be guided through the rest of the installation and ou can get further help by running

		php installation/joomla.php help install


4. CONFIGURE Joomla

	You can now launch your browser and point it to your Joomla! site eg

		http://www.example.org -> Main Site
		http://www.example.org/administrator -> Admin

	You can log into Admin using the username and password that you chose
	during the install.


Joomla! ADMINISTRATION
----------------------

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 (JED): https://extensions.joomla.org/

You can also install and use the `Install from Web Tab` to access the JED
directly from the Admin here:
http://www.example.org/administrator/index.php?option=com_installer&view=install
