Introduction
SuiteCRM is a free and open-source customer relationship management (CRM) software. This tutorial will guide you through the process of installing SuiteCRM on Debian 12.
Prerequisites
Before you begin, ensure you have:
- A Debian 12 server
- Root or sudo access to the server
- Basic knowledge of Linux command line
Step 1: Install LAMP Stack
SuiteCRM requires a LAMP (Linux, Apache, MySQL, PHP) stack to run. Install the required packages:
sudo apt update
sudo apt install apache2 mysql-server php php-mysql libapache2-mod-php php-curl php-json php-mbstring php-xml php-zip unzip -y
Step 2: Create MySQL Database and User
Login to MySQL as the root user:
sudo mysql -u root -p
Create a new database for SuiteCRM:
CREATE DATABASE suitecrm_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
Create a new user and grant permissions to the database:
CREATE USER 'suitecrm_user'@'localhost' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON suitecrm_db.* TO 'suitecrm_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;
Step 3: Download SuiteCRM
Download the latest version of SuiteCRM from the official website:
cd /tmp
wget https://suitecrm.com/download/latest -O suitecrm.zip
Unzip the downloaded file:
sudo unzip suitecrm.zip -d /var/www/html/
Step 4: Set Permissions
Change ownership of the SuiteCRM files:
sudo chown -R www-data:www-data /var/www/html/SuiteCRM/
sudo chmod -R 755 /var/www/html/SuiteCRM/
Step 5: Configure Apache
Create a new virtual host configuration file:
sudo nano /etc/apache2/sites-available/suitecrm.conf
Add the following content:
<VirtualHost *:80>
ServerAdmin [email protected]
DocumentRoot /var/www/html/SuiteCRM/
ServerName your_domain.com
ServerAlias www.your_domain.com
<Directory /var/www/html/SuiteCRM/>
Options FollowSymlinks
AllowOverride All
Require all granted
</Directory>
ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
Enable the virtual host and restart Apache:
sudo a2ensite suitecrm.conf
sudo systemctl restart apache2
Step 6: Complete Installation via Web Browser
Open your web browser and navigate to http://your_domain.com. Follow the on-screen instructions to complete the installation process, providing the database details created earlier.
Conclusion
Congratulations! You have successfully installed SuiteCRM on Debian 12. You can now start using SuiteCRM to manage your customer relationships.
