How to Install Krayin CRM on Ubuntu 24.04

Krayin CRM is one of the rising open-source Customer Relationship Management (CRM) solutions, especially for businesses that need a customer database system, sales pipelines, and deal management without licensing costs. Built on Laravel, Krayin offers high flexibility, is easy to extend, and can be hosted on your own server. In this tutorial, you will learn how to install Krayin CRM from scratch until it is fully operational.

Introduction to Krayin CRM

Krayin CRM is an open-source CRM platform built on Laravel, designed to simplify customer relationship management. Its main focus is modularity and flexibility, making it suitable for SMEs, startups, and enterprises that need a custom CRM.

Key features of Krayin CRM include:

• Customer & organization management
• Sales pipelines and stages
• Activities and interaction logs
• Deal & quotation management
• Analytics dashboard
• Modular and easy-to-develop system
• Free and open source

With Laravel as its foundation, Krayin makes it easy for developers to build new modules according to business needs.

System Requirements

System requirements for running Krayin CRM:

• 4GB RAM
• Apache or Nginx web server
• PHP 8.2+
• MySQL 5.7+ or MariaDB 10.2+
• Composer 2.5+

Install LAMP Stack

Before installing, ensure your server is prepared with the following packages:

sudo apt update && sudo apt upgrade -y
sudo apt install apache2 certbot python3-certbot-apache mariadb-server mariadb-client git unzip -y

Add the Ondřej PHP PPA repository:

sudo add-apt-repository ppa:ondrej/php -y
sudo apt upgrade -y

Install PHP 8.2 and required extensions:

sudo apt install libapache2-mod-php8.2 php8.2 php8.2-cli php8.2-common \
  php8.2-apcu php8.2-mbstring php8.2-gd php8.2-intl \
  php8.2-xml php8.2-soap php8.2-bcmath php8.2-mysql php8.2-zip \
  php8.2-curl php8.2-tidy php8.2-imagick -y

Install Composer:

sudo wget https://getcomposer.org/download/latest-stable/composer.phar -O /usr/local/bin/composer
sudo chmod +x /usr/local/bin/composer

Create the Database

Login to MariaDB:

sudo mysql

Create the database and user:

CREATE DATABASE krayin;
CREATE USER 'krayin'@'localhost' IDENTIFIED BY 'secretpassword';
GRANT ALL PRIVILEGES ON krayin.* TO 'krayin'@'localhost';
FLUSH PRIVILEGES;
exit

Configure Virtual Host

Create an Apache virtual host configuration for crm.domain.com:

sudo nano /etc/apache2/sites-available/crm.domain.com.conf

Insert the configuration:

<VirtualHost *:80>
    ServerName crm.domain.com
    DocumentRoot /var/www/crm.domain.com/public
    <Directory /var/www/crm.domain.com/public>
        Options -Indexes +FollowSymLinks +MultiViews
        AllowOverride All
        Require all granted
    </Directory>
    ErrorLog /var/log/apache2/crm.domain.com_error.log
    CustomLog /var/log/apache2/crm.domain.com_access.log combined
</VirtualHost>

Enable the site and restart Apache:

sudo a2ensite crm.domain.com
sudo systemctl restart apache2  

Request SSL certificate:

sudo certbot --non-interactive \
  -m [email protected] \
  --agree-tos \
  --no-eff-email \
  --apache -d crm.domain.com \
  --redirect

Install Krayin

Create a Krayin project with Composer:

composer create-project krayin/laravel-crm crm.domain.com

Install Krayin CRM:

cd crm.contoh.com
php artisan krayin-crm:install

Follow the Krayin CRM installation prompts:

Please enter the application name
Krayin CRM

Please enter the application URL
https://crm.domain.com 

Please select the default application locale
English

Please select the default currency
Indonesian Rupiah

Please select the database connection
mysql 

Please enter the database host
127.0.0.1

Please enter the database port
3306

Please enter the database name
krayin

Please enter the database prefix
tekan ENTER 

Please enter your database username
krayin

Please enter your database password
rahasia

Enter the name of the admin user
admin 

Enter the email address of the admin user
[email protected] 

Configure the password for the admin user
adminsecretpassword

Message displayed after installation completes:

Congratulations!
The installation has been finished and you can now use Krayin.
Go to http://localhost/admin/dashboard and authenticate with:
Email: [email protected]
Password: adminsecretpassword
Cheers!

 _   __                _       
| | / /               (_)      
| |/ / _ __ __ _ _   _ _ _ __  
|    \| '__/ _` | | | | | '_ \ 
| |\  \ | | (_| | |_| | | | | |
\_| \_/_|  \__,_|\__, |_|_| |_|
                  __/ |        
                 |___/         



Welcome to the Krayin project! Krayin Community is an open-source CRM solution
which is built on top of Laravel and Vue.js.

Made with 💖  by the Krayin Team. Happy helping :)

Open the .env file:

nano .env

Set the following configuration:

APP_ENV=production
APP_DEBUG=false
APP_TIMEZONE=Asia/Jakarta

Move the Krayin CRM directory to /var/www:

sudo mv ../crm.domain.com /var/www

Set the correct user ownership:

cd /var/www
sudo chown -R www-data:www-data crm.domain.com

Access https://crm.domain.com. Krayin CRM is now ready to be used for your sales operations and customer management needs.

Conclusion

Krayin CRM is a flexible, lightweight, and easy-to-develop open-source CRM solution. By hosting it on your own server, you gain full control over customer data and business workflows. Hopefully, this tutorial helps you install Krayin CRM more easily and efficiently. If you want to integrate advanced features such as automation, email notifications, or custom modules, Krayin provides a very developer-friendly architecture. Happy exploring!