Instalación local de Dolibarr

Dolibarr erp/crm es un software de Planificación de Recursos Empresariales (erp en inglés) y de Gestión de Relaciones con los Clientes (crm en inglés) para la pequeña y mediana empresa, independientes o asociaciones.
Le permite gestionar las actividades de su organización (contactos, proveedores, facturas, órdenes, inventarios, agenda, etc.)
Está disponible bajo licencia gnu/gpl y es desarrollado en php.

Supuestamente, la manera más sencilla de instalar Dolibarr en un sistema basado en Ubuntu (yo estaba tratando de hacerlo sobre Pop!_OS) es utilizando el instalador dolibarr_24.0.1-4_all.deb.
Pero, en mi caso, no funcionó.

Así que, como alternativa, probé con los pasos indicados por Josphat Mutai en Computing for Geeks que sí me funcionaron y que, a modo de bitácora, dejo aquí registrado.

Para instalar Dolibarr erp/crm debe asegurarse de tener previamente instalado el servidor web Apache, php y un servidor de bases de datos (mysql o Mariadb).

Paso 1

Para instalar php y sus extensiones, escriba en una terminal:

sudo apt update
sudo apt install -y php php-cli php-mysql php-common php-zip php-mbstring php-xmlrpc php-curl php-soap php-gd php-xml php-intl php-ldap php-imap

También instale la extensión libapache2-mod-php escribiendo:

sudo apt install -y libapache2-mod-php

Configure la instalación de php. Abra el archivo php.ini escribiendo en la terminal:

sudo nano /etc/php/*/apache2/php.ini

En ese archivo de texto:

• busque la línea que dice ;dat.timezone = y bórrele el ; del principio y agregue la zona horaria que corresponda. En mi caso quedó así:

date.timezone = America/Montevideo

• busque la línea que dice memory_limit = 128M y cambie ese valor por 256M
• busque la línea que dice upload_max_filesize = 2M y cambie ese valor por 64M
• busque la línea que dice display_errors = Off y cambie ese valor por On
• busque la línea que dice log_errors = On y cambie ese valor por Off

Paso 2

Instale Mariadb. Escriba en la terminal:

sudo apt install mariadb-server mariadb-client

Asegure la instalación escribiendo:

sudo mysql_secure_installation

y conteste las 6 o 7 preguntas que le hace el script.

Para iniciar sesión en la consola de mysql como usuario root, escriba:

sudo mysql -u root -p

Y luego, para crear la base de datos, escriba en la consola lo siguiente (sustituya el texto ContraseñaFuerte por uno a su elección):

CREATE USER 'dolibarr'@'localhost' IDENTIFIED BY 'ContraseñaFuerte';
CREATE DATABASE dolibarr;
GRANT ALL PRIVILEGES ON dolibarr.* TO 'dolibarr'@'localhost';
FLUSH PRIVILEGES;
QUIT

Para corroborar que puede iniciar sesión en la consola de la base de datos como usuario dolibarr, escriba:

mysql -u dolibarr -p

Le pedirá que ingrese la contraseña que definió (en donde decía ContraseñaFuerte).

Si pudo iniciar la sesión, escriba SHOW DATABASES; y dé Enter, verá algo similar a la siguiente captura de pantalla:

Para salir de la consola de la base de datos, escriba exit y dé Enter

Paso 3

Descargue la versión más reciente de Dolibarr erp/crm utilizando el comando wget:

release_tag=$(curl -s https://api.github.com/repos/Dolibarr/dolibarr/releases/latest | grep tag_name | cut -d '"' -f 4)
wget https://github.com/Dolibarr/dolibarr/archive/${release_tag}.tar.gz

Extraiga el archivo descargado, escribiendo:

tar xvf ${release_tag}.tar.gz

Mueva el directorio creado por la extracción a /var/www/dolibarr

sudo mv dolibarr-${release_tag} /var/www/dolibarr

Luego defina los permisos apropiados:

sudo chown -R www-data:www-data /var/www/dolibarr

Paso 4

Instale y configure el servidor web Apache2.

Instálelo escribiendo:

sudo apt -y install apache2
sudo a2enmod rewrite

Cree un archivo de host virtual para vTiger:

sudo nano /etc/apache2/sites-enabled/dolibarr.conf

Y en ese archivo ingrese lo siguiente:

<VirtualHost *:80>
     ServerAdmin webmaster@example.com
     ServerName erp.example.com
     ServerAlias www.erp.example.com
     DocumentRoot /var/www/dolibarr/htdocs/

     <Directory /var/www/dolibarr/htdocs>
        Options +FollowSymlinks
        AllowOverride All
        Require all granted
     </Directory>

     ErrorLog /var/log/apache2/dolibarr_error.log
     CustomLog /var/log/apache2/dolibarr_access.log combined
</VirtualHost>

<VirtualHost *:80>
     ServerAdmin webmaster@example.com
     ServerName erp.example.com
     ServerAlias www.erp.example.com
     DocumentRoot /var/www/dolibarr/htdocs/

     <Directory /var/www/dolibarr/htdocs>
        Options +FollowSymlinks
        AllowOverride All
        Require all granted
     </Directory>

     ErrorLog /var/log/apache2/dolibarr_error.log
     CustomLog /var/log/apache2/dolibarr_access.log combined
</VirtualHost>

Verifique la sintaxis, escribiendo:

sudo apachectl -t

Reinicie el servicio apache2

sudo a2dissite 000-default.conf
sudo rm /var/www/html/index.html
sudo systemctl restart apache2

Paso 5

Finalice la instalación de Dolibarr en el navegador web, escriba localhost en la dirección url y siga los pasos que se indican.

1. Defina el idioma y pinche en Siguiente paso ->

2. Comprobación de prerrequisitos. Si todos los items están aprobados (con el tick verde), pinche en el botón Empezar para empezar la instalación del programa.

3. Ingrese la información de la base de datos:
   • Nombre de la base de datos: dolibarr
   • Controlador de base de datos PHP: mysqli (MySQL or MaraDB >=5.0.3)
   • Servidor de la base de datos: localhost
   • Login: dolibarr
   • Contraseña: ContraseñaFuerte (la que definió en el paso 2 de este tutorial)

Pinche en Siguiente paso ->

4. Se abre una página de comprobación y, si todo está aprobado, pinche en Siguiente paso -> para guardar la configuración.

5. En la siguiente página (que puede demorar en cargar) se crean los objetos de la base de datos. Luego pinche en Siguiente paso ->.

6. El último paso es configurar el inicio de sesión del administrador:

Y pinche en Siguiente paso -> para terminar la instalación.

La siguiente pantalla le dirá:

• Que el usuario administrador ha sido creado.
• Por razones de seguridad le pedirá que agregue un archivo llamado install.lock en el directorio documents de Dolibarr (para cumplir con esto, genere un archivo vacío con ese nombre y colóquelo en el directorio indicado, en mi caso: var/www/dolibarr/documents).
• Y mostrará un vínculo para acceder al área de configuración del programa para definir su apariencia, funcionalidades, etc.

En caso de que los pasos previamente indicados no me hubieran funcionado, ya tenía en las gateras un videotutorial para probar.

No lo necesité, pero acá lo dejo por si a alguien le viene bien: