Installing EspoCRM on Clear Linux Latest

EspoCRM is a web-based customer relationship management (CRM) platform that enables businesses to effectively manage their interactions with potential and existing customers. In this tutorial, we will guide you on how to install EspoCRM on Clear Linux latest release.

Prerequisites

Before installing EspoCRM, make sure that you have the following:

A Linux system running Clear Linux latest release.
Apache or NGINX web server installed and configured.
PHP version 7.2 or above installed and configured.
MySQL or MariaDB database server installed and configured.
Git installed.

Step 1 - Install Dependencies

The first step is to install the required dependencies for EspoCRM. We can do this by running the following command:

sudo swupd bundle-add php-basic devpkg-libmcrypt devpkg-libjpeg-turbo

This command installs PHP, libmcrypt, and libjpeg-turbo packages, which are required by EspoCRM.

Step 2 - Configure the Web Server

EspoCRM requires a web server to run. You can use Apache or NGINX as a web server. Here, we will use Apache as our web server.

Install Apache

To install Apache, run the following command:

sudo swupd bundle-add apache-httpd

Start Apache

To start the Apache service, run the following command:

sudo systemctl enable httpd
sudo systemctl start httpd

Configure Apache

Next, we need to create an Apache virtual host configuration file for EspoCRM. Run the following command to create the file:

sudo nano /etc/httpd/conf.d/espocrm.conf

Add the following configuration code to the file:

<VirtualHost *:80>
    ServerAdmin [email protected]
    DocumentRoot /var/www/html/espocrm
    ServerName example.com
 
    <Directory /var/www/html/espocrm>
        Options FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>
 
    ErrorLog /var/log/httpd/espocrm_error_log
    CustomLog /var/log/httpd/espocrm_access_log common
</VirtualHost>

Make sure to replace the ServerName and DocumentRoot values with your own information. Save and close the file.

Restart Apache

To apply the changes, restart the Apache service by running the following command:

sudo systemctl restart httpd

Step 3 - Install EspoCRM

To install EspoCRM on Clear Linux, we need to perform the following tasks:

Clone the EspoCRM repository

Run the following command to clone the EspoCRM repository to the Apache document root folder:

sudo git clone https://github.com/espocrm/espocrm.git /var/www/html/espocrm

Set the file permissions

Next, we need to set the file permissions for the EspoCRM directory recursively. Run the following command:

sudo chown -R apache:apache /var/www/html/espocrm
sudo chmod -R 755 /var/www/html/espocrm

Set up the database

Next, we need to set up the database for EspoCRM. Create a new database for EspoCRM using the following commands:

sudo mysql -u root -p

CREATE DATABASE espocrm;
GRANT ALL PRIVILEGES ON espocrm.* TO 'espouser'@'localhost' IDENTIFIED BY 'password';
FLUSH PRIVILEGES;
QUIT;

In the above commands, replace espouser and password with your own desired username and password for the database.

Step 4 - Configure EspoCRM

The final step is to configure EspoCRM. We can do this by performing the following tasks:

Configure the app/config.php file

Run the following command to configure the EspoCRM app/config.php file:

sudo nano /var/www/html/espocrm/app/config.php

Configure the database parameters as shown below:

/* Database */
'database' => [
    'driver' => 'pdo_mysql',
    'host' => 'localhost',
    'dbname' => 'espocrm',
    'user' => 'espouser',
    'password' => 'password',
    'charset' => 'utf8mb4',
    'collation' => 'utf8mb4_unicode_ci',
    'prefix' => '',
],

Make sure to replace the espouser and password values with the ones you created in the previous step.

Configure SELinux

If SELinux is enabled on your system, you need to configure it to allow Apache to write to the EspoCRM directory. Run the following command:

sudo chcon -Rt httpd_sys_rw_content_t /var/www/html/espocrm

Ensure the PHP modules are enabled

Finally, make sure the necessary PHP modules are enabled in the Apache configuration. Run the following command:

sudo nano /etc/php.ini

Scroll down to the "Dynamic Extensions" section and ensure that the following extensions are enabled:

extension=mysqli
extension=mbstring
extension=json
extension=ldap

Save and close the file.

Step 5 - Access EspoCRM

You can now access EspoCRM by opening a web browser and navigating to your server's IP address or domain name. You should see the EspoCRM setup page. Follow the on-screen instructions to complete the setup process.

Conclusion

In this tutorial, we have shown you how to install EspoCRM on Clear Linux latest release. The installation process is straightforward, and once completed, you can start using EspoCRM to manage your customer interactions more efficiently.