 | CiviCRM 2.0 Server Requirements
Before beginning the install process, please verify that your server meets the requirements for CiviCRM 2.0.
- PHP 5.2.x : Starting with the 1.9 release, CiviCRM will NOT run on PHP4 servers* (more info...).
- MySQL 5.0.x or higher with INNODB support : CiviCRM is compatible with the current generally available MySQL release.
- Joomla! 1.0.14 : CiviCRM 2.0 is compatible with Joomla! 1.0.14. We expect the next CiviCRM release to be compatible with Joomla! 1.5.
If you are upgrading from v1.9 to v2.0 - use these instructions. |
| Getting Support for CiviCRM Installation Issues
The CiviCRM Community Forum is the best place to find answers to your installation questions. Start by searching for posts with the same or similar issues. If you don't find an answer, then post your issue with a descriptive title and details of your installation environment, the steps you've taken, and specific error messages (if any). |
The CiviCRM component for Joomla! is larger than the limits set for PHP uploads on most systems. Therefore it is recommended that you use the Install from Directory method for installation. Follow the specific steps below for your Joomla! version.
Joomla! Installation Steps
- Verify whether your server / host is running PHP4 or PHP5. CiviCRM 2.0 is NOT compatible with PHP4.
- Go to http://sourceforge.net/project/showfiles.php?group_id=177914.
- Download the CiviCRM 2.0 for Joomla distribution file (e.g. civicrm-2.0.xxx-joomla.zip).
- Upload this file to your joomlaroot/administrator/components/com_installer/component/ . Unzipping will create a directory called: com_civicrm.
- Login to your Joomla Administrator site.
- Go to Installers menu >> Components
- Use Install from Directory - and enter the full path to the un-zipped com_civicrm directory, which should be something like your_ joomlaroot/administrator/components/com_installer/component/com_civicrm. Click Install.
- You should see "Component successfully installed" message.
 |
This Step is Required for Joomla 1.0.x ONLY
This step should be skipped for Joomla 1.5 which has built in session support for the front end. |
Trouble-shooting
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 directories manually and then try each of the following before attempting to reinstall:
- In your php.ini file or in .htaccess file in the Joomla root folder (if your server allows it), increase the max_execution_time to 600 and memory limit to more than 32M.
php_value memory_limit 64M
php_value register_globals off
php_value max_execution_time 60
- 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.
Additional Resources
