OroCRM Installation guide

I will show you here how to install OroCRM in your machine. OroCRM is the latest open-source CRM tool developed by MageCore. It’s little difficult to make it work on your system as there are some issues which occurs in installing it, and there is also no thorough documentation as of now. It’s in pre-alpha release and just publicly available since 3 weeks. I will show you how to install OroCRM assuming you have Linux system.

Requirements: Symfony 2, Doctrine 2, PHP >= 5.3.3

– Clone the CRM application Git repository in your local. It should be done in your web server’s root directory (e.g. /var/www/).

1

git clone http://gitlab.orocrm.com/crm-application.git

– Now switch to the newly created crm-application directory and make the parameters.yml file with your configuration changes.

1
2
3

cd crm-application
cp app/config/parameters.dist.yml app/config/parameters.yml
vi app/config/parameters.yml

– Edit composer.json, add symfony/assestic-bundle to prevent future error:

PHP Fatal error: Class ‘Assetic\Util\PathUtils’ not found in /var/www/crm-application/vendor/symfony/assetic-bundle/Symfony/Bundle/AsseticBundle/Command/DumpCommand.php on line 216

1
2
3
4
5
6

replace:
"require": {
        "php": ">=5.3.3",
        "oro/platform": "dev-master",
        "oro/crm": "dev-master"
    },

with

1
2
3
4
5
6

"require": {
        "php": ">=5.3.3",
        "oro/platform": "dev-master",
        "oro/crm": "dev-master",
        "symfony/assetic-bundle": "2.3.*@dev"
    },

– This will install composer. If you already have it, just ignore this step.

1

curl -s https://getcomposer.org/installer | php

– This will install all the things which are listed in composer.json file and necessary by Oro; like zendframework, doctrine, twig, symfony, monolog, oro, etc..

1

php composer.phar install --prefer-dist

Change permissions of cache and logs directory to world-writeable. Otherwise you will get errors like:

PHP Fatal error: Uncaught exception ‘RuntimeException’ with message ‘Unable to write in the logs directory (/var/www/crm-application/app/logs)\n’ in …
PHP Fatal error: Uncaught exception ‘RuntimeException’ with message ‘Unable to create the cache directory (/var/www/crm-application/app/cache/prod)\n’ in …

1
2
3

chmod -R 777 app/cache
chmod -R 777 app/logs
or,  find app/cache app/logs -type d -exec chmod 777 {} +

– Finally, run the install bash script

1

./install.sh

You should now able to see the login screen of OroCRM if everything went good. If you face any error, check below errors and how to solve it.

Login credentials are:
username: admin
password: admin

—————-

Fatal error: Class ‘Assetic\Util\PathUtils’ not found in /var/www/crm-application/vendor/symfony/assetic-bundle/Symfony/Bundle/AsseticBundle/Command/DumpCommand.php on line 216

edit composer.json, replace:

1
2
3
4
5

"require": {
        "php": ">=5.3.3",
        "oro/platform": "dev-master",
        "oro/crm": "dev-master"
    },

with

1
2
3
4
5
6

"require": {
        "php": ">=5.3.3",
        "oro/platform": "dev-master",
        "oro/crm": "dev-master",
        "symfony/assetic-bundle": "2.3.*@dev"
    },

and run

1
2

php composer.phar upate --prefer-dist
./install.sh

—————-

Are you missing JS and CSS files? Skinless? Run below two commands.

1
2

php composer.phar upate --prefer-dist
php app/console assetic:dump

It will output:
Dumping all dev assets.
Debug mode is off.

04:55:49 [dir+] /var/www/crm-application/app/../web/css
04:55:49 [file+] /var/www/crm-application/app/../web/css/oro.all.css
04:55:55 [file+] /var/www/crm-application/app/../web/css/oro.css
04:55:59 [file+] /var/www/crm-application/app/../web/js/oro.all.js
04:56:54 [file+] /var/www/crm-application/app/../web/css/oro.user.css
04:56:57 [file+] /var/www/crm-application/app/../web/js/oro.user.js
04:57:00 [file+] /var/www/crm-application/app/../web/js/oro.user.show.js
04:57:01 [file+] /var/www/crm-application/app/../web/js/orocrm.account.account.js
04:57:02 [file+] /var/www/crm-application/app/../web/js/orocrm.contact.js
04:57:03 [file+] /var/www/crm-application/app/../web/js/oroapp.all.js
04:57:09 [file+] /var/www/crm-application/app/../web/css/oro.crm.css

—————-

After login, are you seeing the below message?

ERROR:
Translator.locale = ‘en’;
Translator.defaultDomains = [“messages”];
Translator.add(“validators:You must select at least {{ limit }} role”, “You must select at least {{ limit }} role.|You must select at least {{ limit }} roles.”);

Just remove “i18n/validators/en” from the URL and submit the base URL. You should see the OroCRM Dashboard.

—————

Create apache virtualhost at /etc/apache2/sites-available/orocrm to access OroCRM by http://dev.orocrm.local/ from your browser.
Notice the document root is web directory.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

<VirtualHost *:80>
        ServerAdmin webmaster@localhost
        ServerName  dev.orocrm.local

        DocumentRoot /var/www/crm-application/web
        <Directory /var/www/crm-application/web/>
                Options Indexes FollowSymLinks MultiViews
                AllowOverride All
                Order allow,deny
                allow from all
        </Directory>

        ErrorLog ${APACHE_LOG_DIR}/error.log
        LogLevel warn
        CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>

enable the site and reload web server

1
2

a2ensite orocrm
service apache2 reload

add entry to hosts file
vi /etc/hosts
and add

1

127.0.0.1		dev.orocrm.local