Installation of vtiger CRM on Mac OS X

Although not listed on the vtiger website, it is possible to install vtiger CRM on Mac OS X. I'll briefly describe the steps I went through to get it to work.

The components on Mac OS X

This didn't require MacPorts, although I fully expected to have to install it. That's good, I'm glad I didn't have to go through that process.

The Installation Process

  1. Install the latest MySQL 5.4.1. I'm aware that MySQL comes bundled with OS X beyond 10.2 (or thereabouts), but I wanted the latest. I actually decided to use a beta, knowing that I could use a previous stable version if necessary. This is just a proof of concept.
  2. Install MAMP 1.7.2 from the dmg file
  3. Download the source of vtigercrm
  4. Extract the vtigercrm archive
  5. Place the vtigercrm folder in the Applications/MAMP/htdocs folder
  6. Change the php.ini settings to fit what's described in the vtigercrm linux installation documents. The installation process will tell you some of the settings to change. If you change them later while MAMP's running, you'll have to stop and start the servers for each php.ini change
  7. Launched MAMP (from the Applications folder)
  8. Launched PHPAdmin
  9. Created a MySQL user "vadmin"
  10. Granted global privileges to everything to the user vadmin. Note that is for a proof of concept, there's no way I'd allow this anywhere near production.
  11. Launched the vtiger installation process, providing the vadmin user's details

Some of the back-and-forth issues

At step 10, I originally created a database in PHPAdmin and tried using that, but just couldn't get the vtiger installation process to work for me. So I tried different combinations of creating a database from within the installation process, using a database I'd already created for the purpose, entering "localhost", "%" or my actual hostname, etc. I deleted all the created databases, install logs, etc and let vtiger installation create the database. It worked better that way.

Following some other instructions, I had also added the mysql path to the environment path in the Terminal.


Trackback URL for this post:

http://www.awardsounds.com/trackback/370