The following documentation is for SuiteCRM Version 8+; to see documentation for Version 7, click here.
This page explains how to use the UI installer for SuiteCRM.
Before going through the steps on this page, please go through the Downloading & Installing guide.
To run the web installer go to https://<your-suite-crm-instance-path>/
Since you are not installed this should re-direct you to https://<your-suite-crm-instance-path>/#/install
Where you should see a view like the following
In order to be able to install you’ll have to accept the license by checking the I ACCEPT
checkbox.
The next step is to add the base system configuration in order for your system to work.
On this page apart from Ignore system check warnings
all fields are required and need to be set a value.
In this tab you will find the following configurations:
In the above field you should set the url where your SuiteCRM instance is located. A few example:
Tip: you can simply copy the url from you browser’s address bar
In the above field you should set the user name for accessing your database.
Ensure that the Database User you specify has the permissions to create and write to the SuiteCRM database.
In the above field you should set the password for accessing your database.
In the above field you should set the host of your database.
In some systems when using localhost
doctrine will try to use socket connection. However, socket connection is not supported at the moment, so in such cases, its maybe best to try with the ip, e.g. 127.0.0.1
In the above field you should set the name you want for the databases that will be created on your host during the install process, e.g. suite
or suitecrm
or another valid db name.
In the above field is set to the default port user in mysql
and mariadb
database engines. You should only change it in case your database host is using a different port.
In the above field you can set if, during the install process, you want to pre-populate your database with demo data.
In the above field you can set the username for your SuiteCRM instance’s administrator user, e.g. admin
or any other username you want to give.
In the above field you can set the password for your SuiteCRM instance’s administrator user.
Before running the install process, SuiteCRM is going to check for some system requirements, like max upload file size
or memory limit
. Some of these checks are optional, meaning that you can install the system without those.
In case you want to proceed with the installation even if there are warnings you can check the Ignore System Check Warnings
checkbox
After you have accepted the license and set correct values for all the configurations you can click on Proceed
.
This is going to trigger the install process. As explained before the install process will first check for some system requirements.
If there any errors during the validation, the install process will halt and a modal will open with a description of the checks that failed.
If all the checks passed the system will continue on to the install process. During the install process you will see a loading spinner on the page. This process can take some time.
After the install process finishes you will be re-directed to the login page.
Please double-check that the following configurations are correct
1 - Legacy config in public/legacy/config.php
site_url
:
if you do not have your vhost pointing to the public
dir within your SuiteCRM 8 root folder, you should append /public
to your current host
e.g. if your address is something like https://your-host/crm/public
,
2 - .htaccess
in public/legacy/.htaccess
RewriteBase
If you have your vhost pointing to legacy
dir within the SuiteCRM 8 root folder. Then the correct value is RewriteBase /legacy
Otherwise, you should prepend the path until the public
folder.
e.g. if your address is something like https://your-host/crm/public
, then the correct value is RewriteBase /crm/public/legacy
Try to login into your instance
Content is available under GNU Free Documentation License 1.3 or later unless otherwise noted.