Cómo instalar SuiteCRM en Debian 12

SuiteCRM es un software CRM (Gestión de Relaciones con Clientes) gratuito y de código abierto escrito en PHP. Te ayuda a organizar y gestionar los departamentos de marketing, ventas y servicio al cliente de tu negocio. SuiteCRM es adecuado para casi todas las industrias, como la manufactura, los sectores públicos, la tecnología, las finanzas, la educación, etc.

En esta guía, te guiaremos paso a paso a través de la instalación de SuiteCRM en el servidor Debian 12. Instalarás y ejecutarás SuiteCRM con el LAMP Stack (Apache2, MariaDB y PHP) en tu máquina Debian. También asegurarás SuiteCRM con certificados SSL/TLS de Letsencrypt.

Prerequisitos

Los siguientes requisitos son necesarios para continuar con esta guía:

• Un servidor Debian 12.
  Un usuario no root con privilegios de administrador.
  Un nombre de dominio apuntando a una dirección IP del servidor.

Instalando Dependencias

SuiteCRM es un software CRM escrito en PHP con MySQL/MariaDB como base de datos. En esta guía, estarás ejecutando SuiteCRM con el LAMP Stack (Apache2, MariaDB y PHP), y ahora instalarás los paquetes del LAMP Stack con extensiones PHP adicionales.

Primero, actualiza tu índice de paquetes de Debian a través del comando apt update a continuación.

sudo apt update

Ahora instala los paquetes del LAMP Stack (Apache2, MariaDB y PHP) con algunas extensiones PHP usando el siguiente comando.

sudo apt install apache2 mariadb-server php php-cli php-mysql php-bcmath php-xml php-zip php-curl php-mbstring php-gd php-tidy php-intl php-cli php-opcache php-soap php-imap php-ldap unzip

Escribe y para continuar con la instalación.

A continuación, ejecuta el siguiente comando systemctl para verificar el servicio apache2. Esto asegurará que el servicio apache2 esté habilitado y en ejecución.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

La salida enabled confirma que apache2 está habilitado, y la salida active (running) confirma que apache2 está en ejecución.

Verifica el servicio mariadb usando el siguiente comando.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Similar a la salida del servicio apache2, deberías ver que el servicio mariadb está habilitado y en ejecución.

Por último, verifica la versión de PHP y algunas extensiones habilitadas ejecutando el siguiente comando.

php -v  
php -m

La siguiente salida te muestra que PHP 8.2 está instalado con algunos módulos habilitados como curl, exif, fileinfo, y gd.

Configurando el Servidor MariaDB

Después de instalar las dependencias, asegurarás tu instalación del servidor MariaDB y crearás una nueva base de datos y usuario que se utilizarán para SuiteCRM.

Ejecuta el comando mariadb-secure-installation a continuación para asegurar tu servidor MariaDB.

sudo mariadb-secure-installation

Durante el proceso, ingresa Y para confirmar la configuración o n para No y negar los cambios.

• ¿Cambiar a autenticación unix_socket?. Ingresa n y presiona ENTER. El usuario root predeterminado de MariaDB ya está protegido. Opcionalmente, también puedes habilitarlo escribiendo y para sí.
• ¿Cambiar la contraseña de root?. Ingresa y para confirmar y configurar tu nueva contraseña de root de MariaDB.
• ¿Eliminar usuario anónimo?. Ingresa y para confirmar.
• ¿Deshabilitar el inicio de sesión de root de forma remota? Ingresa y para confirmar. Solo se permitirá la conexión local si estás utilizando el usuario root de MariaDB.
• ¿Eliminar la base de datos de prueba y el acceso a ella?. Ingresa y para confirmar y eliminar la base de datos predeterminada ‘test’.
• Por último, ingresa y nuevamente para recargar todos los privilegios de las tablas en tu servidor MariaDB y aplicar nuevos cambios.

Ahora que MariaDB está asegurado, crearás una nueva base de datos y usuario para SuiteCRM.

Inicia sesión en el servidor MariaDB a través del comando cliente mariadb a continuación. Ingresa tu contraseña de root de MariaDB cuando se te solicite.

sudo mariadb -u root -p

A continuación, ejecuta las siguientes consultas para crear una nueva base de datos suitecrmdb y el usuario suitecrm con la contraseña password. Asegúrate de cambiar la contraseña por tu propia contraseña.

CREATE DATABASE suitecrmdb;  
CREATE USER 'suitecrm'@'localhost' IDENTIFIED BY 'password';  
GRANT ALL PRIVILEGES ON suitecrmdb.* TO 'suitecrm'@'localhost';  
FLUSH PRIVILEGES;

Ahora ejecuta la siguiente consulta para verificar el usuario suitecrm.

SHOW GRANTS FOR 'suitecrm'@'localhost';

En la siguiente salida, deberías ver que el usuario suitecrm tiene acceso a la base de datos suitecrmdb.

Escribe quit para salir del servidor MariaDB.

Configurando PHP

Ahora que el servidor MariaDB está configurado, el siguiente paso es configurar tu instalación de PHP. SuiteCRM requiere algunos cambios en las configuraciones de PHP, como custom error_reporting, habilitar el módulo OPCache, y también custom upload_max_filesize y post_max_size.

Abre la configuración predeterminada de PHP /etc/php/8.2/apache2/php.ini y /etc/php/8.2/cli/php.ini usando el siguiente comando del editor nano.

sudo nano /etc/php/8.2/apache2/php.ini  
sudo nano /etc/php/8.2/cli/php.ini

Cambia los parámetros predeterminados de algunas configuraciones usando las siguientes líneas. Asegúrate de ajustar el date.timezone con la zona horaria de tu servidor, y el memory_limit con la memoria del servidor.

date.timezone = Europe/Amsterdam  
  
max_execution_time = 60  
memory_limit = 256M  
  
upload_max_filesize = 25M  
post_max_size = 25M

Cambia el parámetro error_reporting predeterminado así:

error_reporting = E_ALL & ~E_DEPRECATED & ~E_STRICT & ~E_NOTICE & ~E_WARNING

Descomenta el parámetro session.save_path para configurar la ruta de sesión predeterminada a /var/lib/php/sessions.

session.save_path = "/var/lib/php/sessions"

Ahora habilita la extensión OPCache y ajusta algunas configuraciones como las siguientes:

opcache.enable=1  
  
; El tamaño de almacenamiento en memoria compartida de OPcache.  
opcache.memory_consumption=256  
  
; El número máximo de claves (scripts) en la tabla hash de OPcache.  
; Solo se permiten números entre 200 y 100000.  
opcache.max_accelerated_files=20000  
  
; Cuando está deshabilitado, debes restablecer el OPcache manualmente o reiniciar el  
; servidor web para que los cambios en el sistema de archivos surtan efecto.  
opcache.validate_timestamps=0

Guarda y cierra el archivo cuando termines.

Ahora ejecuta el siguiente comando systemctl para reiniciar el servicio apache2 y aplicar los cambios que has realizado.

sudo systemctl restart apache2

Descargando e Instalando SuiteCRM

En este punto, el LAMP Stack ahora está configurado para SuiteCRM. Ahora descargarás el código fuente de SuiteCRM e instalarlo a través de la línea de comandos.

Crea un nuevo directorio /var/www/suitecrm que se utilizará como la instalación de destino para SuiteCRM.

mkdir -p /var/www/suitecrm

Muévete al directorio /var/www/suitecrm y descarga el código fuente de SuiteCRM usando el comando wget a continuación. Asegúrate de consultar la página de descarga de SuiteCRM para obtener la última versión del código fuente. En este momento, SuiteCRM 8.4 es la última versión.

cd /var/www/suitecrm  
wget https://suitecrm.com/download/142/suite84/562972/suitecrm-8-4-0.zip

Una vez descargado, extrae el archivo suitecrm-8-4-0.zip usando el comando unzip a continuación.

unzip suitecrm-8-4-0.zip

Luego ejecuta el siguiente comando para establecer los permisos y la propiedad adecuados del código fuente de SuiteCRM.

find . -type d -not -perm 2755 -exec chmod 2755 {} \;  
find . -type f -not -perm 0644 -exec chmod 0644 {} \;  
find . ! -user www-data -exec chown www-data:www-data {} \;  
chmod +x bin/console

Por último, ejecuta el archivo binario /var/www/suitecrm/bin/console para instalar SuiteCRM a través de la línea de comandos. Asegúrate de cambiar los detalles del nombre de la base de datos, usuario, host, nombre de dominio de destino, usuario administrador y contraseña que se utilizarán para tu instalación de SuiteCRM.

sudo -u www-data ./bin/console suitecrm:app:install -u "alice" -p "password" -U "suitecrm" -P "password" -H "127.0.0.1" -N "suitecrmdb" -S "http://suitecrm.howtoforge.local/"

Una vez que la instalación haya finalizado, la siguiente salida se mostrará en tu terminal:

Configurando el Host Virtual de Apache2 para Suite

En el siguiente paso, crearás una nueva configuración de host virtual de Apache2 que se utilizará para ejecutar SuiteCRM. Antes de continuar, asegúrate de tener un nombre de dominio apuntando a la dirección IP de tu servidor.

Ejecuta el comando a2enmod a continuación para habilitar los módulos de Apache2 que son requeridos por SuiteCRM.

sudo a2enmod rewrite ssl header

Luego, crea una nueva configuración de host virtual de Apache2 /etc/apache2/sites-available/suitecrm.conf usando el siguiente comando del editor nano.

sudo nano /etc/apache2/sites-available/suitecrm.conf

Inserta la siguiente configuración y asegúrate de cambiar la opción ServerName con tu nombre de dominio.

  
  
 DocumentRoot /var/www/suitecrm/public  
 ServerName suitecrm.howtoforge.local  
  
   
    Options FollowSymLinks  
    AllowOverride All  
   
  
 ErrorLog /var/log/apache2/suitecrm-error.log  
 CustomLog /var/log/apache2/suitecrm-access.log common  
  

Guarda y cierra el archivo cuando termines.

Ahora ejecuta el siguiente comando para activar el archivo de host virtual suitecrm.conf y verificar tus configuraciones de Apache2.

sudo a2ensite suitecrm.conf  
sudo apachectl configtest

Si tienes la sintaxis correcta, deberías obtener la salida Syntax OK.

A continuación, ejecuta el comando systemctl a continuación para reiniciar el servicio apache2 y aplicar los cambios.

sudo systemctl restart apache2

Por último, abre tu navegador web y visita el nombre de dominio de tu instalación de SuiteCRM, como http://suitecrm.howtoforge.local/. Si todo va bien, deberías ver la página de inicio de sesión de SuiteCRM.

Asegurando SuiteCRM con SSL/TLS de Letsencrypt

Con todo configurado, ahora asegurarás SuiteCRM con certificados SSL/TLS de Letsencrypt.

Instala Certbot y el plugin Certbot Apache usando el siguiente comando apt install. Escribe y para continuar con la instalación.

sudo apt install certbot python3-certbot-apache

Ahora ejecuta el comando certbot a continuación para generar certificados SSL/TLS. Asegúrate de cambiar el nombre de dominio y la dirección de correo electrónico dentro del siguiente comando.

sudo certbot --apache --agree-tos --no-eff-email  --redirect --hsts --staple-ocsp --email [email protected] -d suitecrm.howtoforge.local

Una vez que el proceso haya finalizado, tus certificados SSL se generarán en el directorio /etc/letsencrypt/live/suitecrm.howtoforge.local. Además, el archivo de host virtual de SuiteCRM suitecrm.conf se configurará automáticamente con HTTPS.

Regresa a tu navegador web y visita el nombre de dominio de tu SuiteCRM, deberías ser redirigido a la página de inicio de sesión de SuiteCRM para conexiones seguras HTTPS. Ingresa tu usuario administrador y contraseña, luego haz clic en Iniciar sesión.

Si todo va bien, deberías ver el panel de administración de SuiteCRM como el siguiente:

Conclusión

Para concluir, ahora has instalado con éxito SuiteCRM en el servidor Debian 12 con LAMP Stack (Apache2, MariaDB y PHP). También has asegurado SuiteCRM con SSL/TLS Letsencrypt, que se generó a través de Certbot. Ahora puedes usar SuiteCRM como la aplicación principal de CRM (Gestión de Relaciones con Clientes) para tu negocio, y puedes comenzar agregando el servidor SMTP a tu instalación de SuiteCRM.