Skip to content

Installation

Requirements

EspoCRM can run on the most hosting providers. Requirements are the following:

  • PHP 7.2 and later,
  • MySQL 5.7 (and later) or MariaDB 10.1 (and later).

See server configuration article for more information.

1. Download the EspoCRM installation package

To get the latest version of EspoCRM follow the download page link.

2. Upload the EspoCRM files to your Server

Once the download is complete, upload the package to your web server. To upload it you can use SSH, FTP or the hosting administration panel. Extract the archive to your public web server directory (e.g., public_html, www, etc.).

Note: If you have only FTP access, you need to extract the archive before uploading to your web server.

3. Create a MySQL Database for EspoCRM to use

Go to your hosting administration panel, or to SSH, and create a new database and user for EspoCRM (e.g., MySQL Databases in cPanel).

4. Run EspoCRM installation process

Now, open your web browser, and go to the URL with EspoCRM files (e.g., http://yourdomain.com/espo).

If you see this screen, you have a "Permission denied" error. You need to execute the displayed command in the terminal via SSH to set correct permissions. It should be 755 for directories, 644 for files, and 775 for data directory. Also make sure that you have the correct owner and group. More info about permissions is available here.

1

If you see the following screen, the permission is correct and you can start installing EspoCRM.

2

On this page, you can read and accept the License Agreement.

3

Enter the details for your newly created MySQL database.

4

Enter the user name and password of Administrator EspoCRM.

5

On this page you can set the default settings of EspoCRM, such as date and time format, timezone, currency and others.

6

Enter SMTP settings for outgoing emails, if you want to have the ability to send emails. This step can be skipped by clicking the Next button. All of these options can be added/changed in EspoCRM after installation.

7

Installation is complete. The last thing is to setup cron (or daemon) in your system. It can be done by running crontab -e in linux cli and in Windows Tasks Scheduler in Windows systems. More info about jobs is here.

8

We hope you will enjoy working in EspoCRM.