Installing Zurmo

Posted by | 33 Comments

Purpose:
To guide individuals through the Zurmo installation.

Audience:
Anyone who wants to equip his machine with Zurmo.

Requirements

Please go through Zurmo Installation Requirements page to setup prerequisites for your machine.

Production

  • Download the latest stable version of Zurmo here
  • Unzip downloaded file into document root of your webserver(actual location may vary depending on your platform)
  • Check with the Installation Requirements page to setup proper write permissions on specific files and directories. This is mandatory
  • In a browser to go http://localhost/zurmo/app/index.php to run the installation
  • Click continue to run a system check
  • Check and fix any issues found by the system check, if necessary rerun tests
  • On next screen you would be prompted to provide Zurmo Install Wizard with your preferred settings
  • You may see memcache configuration on setup form. This is purely optional, though highly recommended for good traffic sites
  • Fill the setup form with database credentials and password for superadmin for Zurmo(you can change this later).
  • Click on install to install the application
  • Once installation is complete you are given the option of installing demo data. For Production it is advised to not install demo data.
  • At the end of the installation you will have a log in link to be able to go to the log in screen

Development

  • Clone the zurmo source code in the document root of your webserver(actual location depends on your platform).
  • Follow the install guide for Production setup above

Leave a Comment

  • PatrizioRullo

    I’m trying to install Zurmo on my Ubuntu 12.04, and it tells me it’s missing the IMAP module (on Ubuntu it’s a package named php5-imap). Can you add this info? Thanks!

    • Ivica Nedeljkovic

      IMAP is optional service, that is why it is not listed under required items.

      • Andrew

        Yeah, but I think that this information should be present at chapters 1,2.

        • Ivica Nedeljkovic

          php-imap is added as optional requirement. Thanks!

  • PatrizioRullo

    I think it’s better to add information about installing php5-curl, needed to call curl.
    I installed curl and the Zurmo installation was saying that it was missing, without help of people from forum, it would take me quite a long time to figure it out.

    • Ivica Nedeljkovic

      I edited article, and added php5-curl as required php library.

  • Cool Lkdop

    once installed on Ubuntu 12.04, I am prompted the login/password. what are they ? I am testing super/super & jim/jim & zurmo/zurmo… not working :(

    Also, when I check Database in phpmmyadmin, there are only table under the ‘zurmo’ database, nothing under ”zurmo_wacky’, is this normal ?

    Thank you for your help

    • Cool Lkdop

      It’s ok, it’s the one set during installation process…

    • Ivica Nedeljkovic

      Login username is ‘super’ and password ins one that you entered during installation(field: “Super User Password “).
      “‘zurmo_wacky” database is used just for unit tests, so after installation this database will be empty. But there will be some tables in this database during unit tests.

  • David Saldana

    I downloaded the 1.5 version, unzip the folder and then try to run as it said above but it does not work, it tells me document not found. what I am doing wrong?

    • http://www.facebook.com/people/Ray-Stoeckicht/100001473956853 Ray Stoeckicht

      Do you have the proper server environment? You can post any error messages and screenshots here: http://zurmo.org/forums/index.php?/forum/8-installation-and-setup/

      • David Saldana

        The server was running version 1.31 so I guess it does had the right server environment. I don’t have any critical data so I wanted to do a fresh install instead of an upgrade

        • http://www.facebook.com/people/Ray-Stoeckicht/100001473956853 Ray Stoeckicht

          We have Developer Sessions every Tuesday at 10:00AM Chicago Time: http://zurmo.org/forums/index.php?/calendar/event/2-developer-learning-session
          You can always join an upcoming session and ask any questions to our technical team.

          • David Saldana

            thanks, I got it working. I change permissions to the folder and it is now installed

          • http://www.facebook.com/people/Ray-Stoeckicht/100001473956853 Ray Stoeckicht

            Fantastic! Glad to hear everything is working now.

  • Kevin

    Getting the following error:

    Warning: include(SecurableModule.php) [function.include]: failed to open stream: No such file or directory in /home/*****/public_html/crm/zurmo/yii/framework/YiiBase.php on line 421

    Warning: include() [function.include]: Failed opening ‘SecurableModule.php’ for inclusion (include_path=’.:/home/*****/public_html/crm/zurmo/app/protected/modules/api/tests/unit/forms:/home/*****/public_html/crm/zurmo/app/protected/modules/api/tests/unit/models:/usr/lib/php:/usr/local/lib/php’) in /home/*****/public_html/crm/zurmo/yii/framework/YiiBase.php on line 421

    Fatal error: Class ‘SecurableModule’ not found in /home/*****/public_html/crm/zurmo/app/protected/modules/zurmo/ZurmoModule.php on line 38

    • Jason Green

      What OS/php/apache versions are you running? did you try restarting memcache and apache? are you running APC, turn off APC and see if it is ok.

      • Kevin

        Hello Jason, I have the following CentOs 5.9 i686 – Apache/2.2.24 (Unix) mod_ssl/2.2.24 OpenSSL/0.9.8e-fips-rhel5 mod_bwlimited/1.4 PHP/5.3.24 mod_perl/2.0.6 Perl/v5.8.8 I tried restarting the memcache and Apache with no success.

        • Jason Green

          Kevin,
          A few other people have had this problem recently, but we can’t seem to replicate it and are not having any problems with our build environments for our servers. it would be great if you could install xdebug on php, and then get us a stack trace of what is going on. this would help immensely.

          • Kevin

            Thank you, I will do so this weekend. Looking forward to using Zurmo…

          • Jason Green

            ok looking forward to seeing the stack trace

          • Kevin

            1.

          • Guest

            2.

          • Kevin

            3.

          • Kevin

            2.

          • http://www.facebook.com/people/Ray-Stoeckicht/100001473956853 Ray Stoeckicht

            Kevin, we have Developer Sessions every Tuesday at 10:00AM Chicago Time (http://zurmo.org/forums/index.php?/calendar/event/2-developer-learning-session/). You can always join an upcoming session so we can go over the issues and help you get them resolved.

          • Kevin H.

            Hello, Sorry I missed the developper session… Was this issue discussed by any chance?

          • http://www.facebook.com/people/Ray-Stoeckicht/100001473956853 Ray Stoeckicht

            No worries. We didn’t discuss any install issues. Maybe you can make next week’s session.

          • http://twitter.com/MarkPDaoust Mark P Daoust

            I’m having the same issues – exact same stack trace. Any ideas?

            I’m installing on Mac OS 10.8 running PHP 5.3

          • http://www.facebook.com/people/Ray-Stoeckicht/100001473956853 Ray Stoeckicht
          • Kevin

            This is the php info of my server, memcache section… People say it’s the memcache but I got the error messages with memcache/memcached installed and not installed.

          • Brisvegan
          • Brisvegan

            Fixed … was permissions issue.