<VirtualHost *:80>
DocumentRoot /<path-to-suite>/public
<Directory /<path-to-suite>/public>
AllowOverride All
Order Allow,Deny
Allow from All
</Directory>
</VirtualHost>
The following documentation is for SuiteCRM Version 8+; to see documentation for Version 7, click here.
This guide contains the steps required to setup a webserver for installing SuiteCRM 8+
The following documentation will use as base setup a LAMP stack: Linux, Apache, MySql and php. However, most of the steps may apply to other webservers and databases
Install the platform-appropriate version of the following:
webserver: apache
php
database: mysql
or mariadb
See the Compatibility matrix to ensure you have the correct versions of the required software.
There are other software dependencies on the Compatibility matrix under the Additional requirements for Development
section,
however those are the ones required for a development environment.
When installing SuiteCRM from pre-build installable package zip you do not need to install the dependencies that are for development, namely: node, angular cli, yarn/npm.
The SuiteCRM 8 pre-built installable package zip comes with the pre-built front end files under public/dist
and all the required libs on vendors.
On how to install a development LAMP stack on Ubuntu:
Install on your server the required php modules:
cli
curl
common
intl
json
gd
mbstring
mysqli
pdo_mysql
openssl
soap
xml
zip
imap (optional)
ldap (optional)
Please check the Helpful Resources
section from Install required software for instructions on how to install php modules
In order for api routes to work you need allow url re-writes.
All SuiteCRM-Core api calls depend on this (calls to api/graphql
) if re-rewrites are not allowed you will get a 404
when calling the api.
In apache
webserver this can be achieved by enabling mod-rewrite and configuring the vhost.
It is highly recommended that you update the webroot or configure vhost to point to the public
folder inside SuiteCRM folder. If the webroot is pointing to SuiteCRM folder instead of the public folder, all the files under SuiteCRM folder maybe be exposed to the web.
Update your vhost configuration to add the following:
<VirtualHost *:80>
DocumentRoot /<path-to-suite>/public
<Directory /<path-to-suite>/public>
AllowOverride All
Order Allow,Deny
Allow from All
</Directory>
</VirtualHost>
Symfony documentation on how to setup webserver (apache and others)
DigitalOcean - Tutorial on how to setup mod_write (apache)
Note from the above you would only need:
Section 1—How to Activate Mod_Rewrites
How to permit changes in the .htaccess file:
Please make sure that notices aren’t considered on error_handling
. For that you can update the error handling entry in php.ini
error_reporting = E_ALL & ~E_DEPRECATED & ~E_STRICT & ~E_NOTICE & ~E_WARNING
Please check the Helpful Resources
section from Install required software for instructions on where to find php.ini
For more information regarding performance optimization see the Performance configuration guide
Content is available under GNU Free Documentation License 1.3 or later unless otherwise noted.