"Fossies" - the Fresh Open Source Software Archive 
As a special service "Fossies" has tried to format the requested text file into HTML format (style:
standard) with prefixed line numbers.
Alternatively you can here
view or
download the uninterpreted source code file.
1 <?php
2 /**
3 * @package Joomla.Installation
4 *
5 * @copyright (C) 2005 Open Source Matters, Inc. <https://www.joomla.org>
6 * @license GNU General Public License version 2 or later; see LICENSE.txt
7 */
8
9 defined('_JEXEC') or die;
10 ?>
11
12 REQUIREMENTS
13 ------------
14
15 First you must have the base environment for Joomla.
16 We have thoroughly tested Joomla! on: Linux, Free BSD, Mac OS X and Windows.
17 Linux or one of the BSD's are recommended, but anything else that can run
18 a supported PHP version, a supported database and a supported web server listed
19 in the Technical Requirements at https://downloads.joomla.org/technical-requirements
20 should do it.
21
22
23 SERVER CONFIGURATION
24 --------------------
25
26 You MUST ensure that PHP has been compiled with support for MySQL (or the database
27 you are using) and Zlib in order to successfully run Joomla.
28
29 While we have reports that Joomla! works on IIS server we recommend Apache
30 for running Joomla! on Windows.
31
32
33 OPTIONAL COMPONENTS
34 -------------------
35
36 If you want support for SEF (Search Engine Friendly) URLs using the Apache web server
37 you'll need mod_rewrite and the ability to use local .htaccess files. If you are using
38 the IIS web server you'll need the ability to use local web.config.txt files
39
40
41 INSTALLATION
42 ------------
43
44 1. DOWNLOAD Joomla
45
46 You can obtain the latest Joomla! release from:
47 https://downloads.joomla.org/latest
48
49 Copy the tar.gz file into a working directory eg
50
51 $ cp JoomlaVx.x.x-Stable.tar.gz /tmp/Joomla
52
53 Change to the working directory eg
54
55 $ cd /tmp/Joomla
56
57 Extract the files eg
58
59 $ tar -zxvf JoomlaVx.x.x-Stable.tar.gz
60
61 This will extract all the Joomla! files and directories. Move the contents
62 of that directory into a directory within your web server's document
63 root or your public HTML directory eg
64
65 $ mv /tmp/Joomla/* /var/www/html
66
67 Alternatively if you downloaded the file to your computer and unpacked
68 it locally use an FTP program to upload all files to your server.
69 Make sure all PHP, HTML, CSS and JS files are sent in ASCII mode and
70 image files (GIF, JPG, PNG) in BINARY mode.
71
72
73 2. CREATE THE Joomla! DATABASE
74
75 Joomla! will currently work with MySQL, MSSQL and PostgreSQL but
76 the following instructions are for MySQL. Refer to the relevant
77 documentation if you are using another database.
78
79 You can use your web control panel or phpMyAdmin to
80 create a database for Joomla.
81
82 Alternatively you can create a database with the CLI.
83 In the following examples, "db_user" is an example MySQL user
84 which has the CREATE and GRANT privileges. You will need to use
85 the appropriate username for your system.
86
87 First, you must create a new database for your Joomla! site eg
88
89 $ mysqladmin -u db_user -p create Joomla
90
91 MySQL will prompt for the 'db_user' database password and then create
92 the initial database files. Next you must login and set the access
93 database rights eg
94
95 $ mysql -u db_user -p
96
97 Again, you will be asked for the 'db_user' database password. At the
98 MySQL prompt, enter following command:
99
100 GRANT ALL PRIVILEGES ON Joomla.*
101 TO nobody@localhost IDENTIFIED BY 'password';
102
103 where:
104
105 'Joomla' is the name of your database
106 'nobody@localhost' is the userid of your web server MySQL account
107 'password' is the password required to log in as the MySQL user
108
109 If successful, MySQL will reply with
110
111 Query OK, 0 rows affected
112
113 to activate the new permissions you must enter the command
114
115 flush privileges;
116
117 and then enter 'exit' or 'quit' to exit MySQL.
118
119 3. WEB INSTALLER
120
121 Finally point your web browser to http://www.example.org where the Joomla! web
122 based installer will guide you through the rest of the installation.
123
124 4. CONFIGURE Joomla
125
126 You can now launch your browser and point it to your Joomla! site eg
127
128 http://www.example.org -> Main Site
129 http://www.example.org/administrator -> Admin
130
131 You can log into Admin using the username and password that you chose
132 during the web based install.
133
134
135 Joomla! ADMINISTRATION
136 ----------------------
137
138 Upon a new installation, your Joomla website defaults to a very basic
139 configuration with only a few active components, modules and templates.
140
141 Use Admin to install and configure additional extensions, add users, select
142 default language and much more.
143
144 Note that additional community contributed extensions and languages are
145 available at the Joomla! Extensions Directory (JED): https://extensions.joomla.org/
146
147 You can also install and use the `Install from Web Tab` to access the JED
148 directly from the Admin here:
149 http://www.example.org/administrator/index.php?option=com_installer&view=install