Server Configuration for EspoCRM

Posted on July 23, 2014 by EspoCRM

EspoCRM can be installed on:

Apache (instructions), Nginx (instructions), or IIS server
with PHP version 7.4 and later
MySQL 5.7 (and later), or MariaDB 10.1 (and later)

Configuration Recommendations for EspoCRM

PHP Requirements

EspoCRM requires PHP 7.3 or greater, with the following extensions enabled:

pdo – for database access;
json;
gd – to manipulate images;
openssl – to ensure the highest protection;
zip – to be able to upgrade EspoCRM and install extensions;
mbstring;
iconv;
curl – for integrations;
xml – for excel export;
xmlwriter – for excel export;
exif – for a proper oriantion of uploaded images.

Optional php extensions that may be needed:

zmq – for websocket;
pcntl – for parallel job processing and daemon (Unix-like systems only);
posix – for Unix-like systems;
ldap – for LDAP authentication.

php.ini settings:

max_execution_time = 180
max_input_time = 180
memory_limit = 256M
post_max_size = 50M
upload_max_filesize = 50M

MySQL Requirements

EspoCRM supports MySQL version 5.7 or greater.
These are no special peculiarities. All default settings are good for EspoCRM.

Required Permissions for Unix-based Systems

The files and directories should have the following permissions:

“/data”, “/custom”, “/client/custom” – should be writable all files, directories and subdirectories (664 for files, 775 for directories, including all subdirectories and files).
“/application/Espo/Modules”, “/client/modules” – should be writable the current directory (775 for the current directory, 644 for files, 755 for directories and subdirectories).
All other files and directories should be readable (644 for files, 755 for directories).

To set the permissions, execute these commands in the terminal:

cd <PATH-TO-ESPOCRM-DIRECTORY>
find . -type d -exec chmod 755 {} + && find . -type f -exec chmod 644 {} +;
find data custom client/custom -type d -exec chmod 775 {} + && find data custom client/custom -type f -exec chmod 664 {} +;
chmod 775 application/Espo/Modules client/modules;

All files should be owned and group-owned by the webserver process. It can be “www-data”, “daemon”, “apache”, “www”, etc.
Note: On Bitnami Stack, files should be owned and group-owned by “daemon” user.
Note: On shared hosts, files should be owned and group-owned by your user account.

To set the owner and group-owner, execute these commands in the terminal:

cd <PATH-TO-ESPOCRM-DIRECTORY>
chown -R <OWNER>:<GROUP-OWNER> .;

Setup a crontab

To setup a crontab on a UNIX system

1. Login as administrator into your EspoCRM instance.
2. Go to the Scheduled Jobs section in the administrator panel (Menu > Administration > Scheduled Jobs) and copy the string for the crontab. It looks like this one:
```
* * * * * /usr/bin/php -f /var/www/html/espocrm/cron.php > /dev/null 2>&1
```
3. Open a terminal and run this command:
```
crontab -e -u WEBSERVER_USER
```
WEBSERVER_USER can be one of the following “www”, “www-data”, “apache”, etc (depends on your webserver).
4. Paste the copied string (from step 2) and save the crontab file (Ctrl+O, then Ctrl+X for nano editor).

Windows

For Windows servers you can utilize Scheduled Tasks.

Configuration instructions based on your server:

L1 says:

August 4, 2014 at 1:28 pm

Got error when running connection-test for MySQL about mcrypt.
Somewhere in php.ini I added mcrytp.so as module to use, still having error:

could not find driver

Ubuntu14.04 64b

What is missing??

August 5, 2014 at 6:28 am

Found out in the meantime:
– had to install php5-gd and php5-mysql, and
– a2enmod rewrite

Billy Wagner says:

October 4, 2014 at 2:22 am

You know what would have been nice. Giving Urls to all the pre reqs.

Renato Frota says:

January 11, 2015 at 10:17 pm

PHP 5.3+ relies on a “.user.ini” file (with the initial dot) to custom variables, not on php.ini.

A php.ini on the app directory will make the server’s standard php.ini not to be loaded and this will cause most of your PHP modules not to be loaded as well (mcrypt, including).

Also, the last line looks as “max execution time” instead “max_execution_time” because of the code box styling (at least on Firefox). 1px padding on “.syntaxhighlighter code” class should resolve this.

chris says:

January 20, 2015 at 12:31 pm

I’ve got the system working, but the charts only show as a x y access line no info or labels? any ideas

Johannes says:

February 5, 2015 at 1:39 pm

Is there any possibility running it with PHP 5.3.29 as well?
Because I’ve got this version provided from my provider and it works well with every other application I installed or tried, so never got this requirement before.

Fn Smith says:

March 2, 2015 at 12:29 pm

Getting the error, “-bash: www-data: No such file or directory” for the command:
chown -R : .;

Panama says:

March 30, 2015 at 7:13 pm

Installation and login no problem
If i want change or upload something i get
the field authentication required (is not a field from Espo)
i have again set the permissions – but allways “authentication requuired”
Is there a solution ?

Minh Hoang says:

May 5, 2015 at 1:44 am

I can’t get pass this.

API Error: EspoCRM API unavailable.
Possible problems: RewriteBase required, disabled “mod_rewrite” in Apache server or .htaccess support.

I have added the rewritebase , server already have mod_rewrite and .htaccess support.

Don’t know what else I can do. PLease help.

Алексей Доронин says:

May 20, 2015 at 8:41 pm

Столкнулся с ошибкой 403 при попытке сохранения настроек “Администрирование”, например в “Интерфейсе пользователя”. Так же подобная ошибка возникает при попытке сохранить любые настройки из “Администрирования” и при закрытии задачи.
Работаю в EspoCRM под администратором.
У меня не все было гладко с установкой: вот эти параметры max_execution_time = 180, max_input_time = 180 у меня были по 60. Может это вызвать такую ошибку?
Конфигурация сервера мне не известна, использую виртуальный хостинг от спринтхоста. Пробовал менять тарифный план на более расширенный – не помогло. Переходить на VDS?

Serhan says:

May 23, 2015 at 10:44 am

Hi,
I did successfully setup.
Adding features works.
During the update features “Error 404” I’m getting.
What should I do? Where is the problem?

Tejshwar says:

April 18, 2017 at 6:49 am

Hi,
Are you trying “Xampp” server.

Lo says:

June 4, 2015 at 11:32 am

Hello,
I managed to install the software EspoCRM . However, when I try to connect , I see nothing. Jj’ai the error message “Auth error” that appears a few seconds and then disappears . Footer , there well with the gray line © 2015 EspoCRM . Could you help me? Thanks in advance, Lo

nasri says:

March 24, 2016 at 1:34 pm

comment faire la connexion entra un formulaire de contact et espocrm?

John says:

April 14, 2016 at 3:27 pm

For those missing mcrypt and imap on clean ubuntu.

sudo apt-get install mcrypt php5-mcrypt
sudo php5enmod mcrypt
sudo apt-get install php5-imap
sudo php5enmod imap
sudo service apache2 restart

nhatdv says:

November 20, 2016 at 3:36 pm

I have already assign 775 permision to data folder but when i install espocrm, it notice error below:
Permission denied for “data” directory. Please set 775 for “data” or just execute this command in the terminal

cd /var/www/html/democrm.apecsoft.net/public_html && find data -type d -exec chmod 775 {} + && chown -R 498:498 .;

Operation not permitted? Try this one: cd /var/www/html/democrm.apecsoft.net/public_html && find data -type d -exec sudo chmod 775 {} + && sudo chown -R 498:498 .;

I have ran all statement above too.

Please have me

Taras Machyshyn says:

November 21, 2016 at 7:34 am

Did you set permission for all subdirectories for “data” directory? Please make sure, that your webserver user/group is “498”.

Tom Hancock says:

January 10, 2017 at 9:49 am

I am stuck on
API Error: EspoCRM API is unavailable.

I ran all statements to try correct it. Tried fixing my virtual host file (which i am not sure if it is correct or not).
Have apache 2.4 installed.
Please help.

Murugappan Ramanathan says:

August 28, 2017 at 10:15 am

I have installed version 4.8.1 and I am getting this Error 403 – Access Denied when i tried to upload the company logo and also when I tried adding the avatar. I looked into the forum and i am really tired as the solutions provided seem to be of no help for someone who is setting EspoCRM on a web hosting site.

Can anyone really help? Otherwise i may have to resort to other CRM software.

Thank you.

Ryan N. says:

August 28, 2017 at 1:25 pm

Please check error logs on your server.

Alexandre says:

October 17, 2017 at 5:18 pm

Hello,
I try to install ESpocrm on Wampserver. When I try to connect after the last step, the error message “Auth error” appears a few seconds and then disappears with a blank page.
Could you please help me?

Thanks in advance,

Alexandre

Mickaël says:

November 15, 2017 at 9:43 pm

Good Evening everybody, I try to install EspoCRM 4.8.4 on my Synology NAS.
i’m using PHPmyadmin 4.4.7 with MariaDB 5.5.47 and PHP version 5.5.33.
When I execute EspoCRM installation, I get this error : Ajax failed:
– Test Connexion with Base is okay
– Set Permissions : 777 (I will modify later)
– Set recommandations are good

I have the same problem with EspoCRM 4.8.2.
Could you help me please ?
Best Regards.
Mickaël.

Tom says:

November 16, 2017 at 8:36 am

Mickaël,
777 permission is not good. Please check apache error log and espocrm error log (espocrm-directory/data/logs/*.log).
Please find some solutions on a forum http://forum.espocrm.com/ or create a topic with your problem.