[Summary view] [Print] [Text view]

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