1. Server Requirements
CiviCRM for Joomla has been developed and tested by our team on the following 'recommended' platforms:
2. Joomla Installed
The automated installer requires Joomla 1.7.x. or 2.5.x If you do not have the required version of Joomla installed, refer to:
3. Download and Un-tar CiviCRM Code
All CiviCRM code and packages used by CiviCRM (such as PEAR libraries) are included in the compressed CiviCRM distribution files ('tarballs'). Follow these steps to download and install the codebase:
Note: when installing a new version over an old one, please check first "6. Trouble-shooting resources" below
4. Run the Installer
5. Create CiviCRM Contacts for Existing Joomla Users
Once installed, CiviCRM keeps your Joomla Users synchronized with corresponding CiviCRM contact records. The 'rule' is that there will be a matched contact record for each Joomla user record. Conversely, only contacts who are authenticated users of your site will have corresponding Joomla user records.
When CiviCRM is installed on top of an existing Joomla site, a special CiviCRM Administrative feature allows you to automatically create CiviCRM contacts for all existing Joomla users:
6. Trouble-shooting Resources
If the CiviCRM component does not install correctly (for example you get a blank screen instead of the confirmation page), delete the ~/components/com_civicrm and ~/administrator/components/com_civicrm and ~/media/civicrm directories manually and then try each of the following before attempting to reinstall:
* CiviCRM is packaged with all the libraries (PEAR etc) that it uses. However a misconfigured or overly restrictive open_basedir directive on your web server might interfere with CiviCRM's ability to access some required files or directories. To turn open_basedir off, add this to your vhost.conf file: php_admin_value open_basedir none or ask your host to either turn it off or ensure that it is not preventing access to required directories (e.g. if you move configuration files or temp folders outside your web root). The configuration of sub domains might cause related issues: try installing in the main domain root or a sub folder instead.
Review the Installation and Configuration Trouble-shooting section of our wiki for help with problems you may encounter during the installation.
You can often find solutions to your issue by searching the installation support section of the community forum OR the community mailing list archives, and you can check out the Installation section of our FAQs.
If you don't find an answer to your problem in those places, the next step is to post a support request on the forum.