
Introducción: ¿Qué es Dolibarr ERP/CRM?
Dolibarr ERP/CRM es un software de código abierto para la planificación de recursos empresariales (ERP) y la gestión de relaciones con clientes (CRM). Está diseñado para pequeñas y medianas empresas, trabajadores autónomos, fundaciones y asociaciones. Dolibarr combina sencillez con una amplia gama de funciones, incluyendo facturación, gestión de ventas, gestión de proyectos, inventario, contabilidad y recursos humanos. A diferencia de otras soluciones ERP, Dolibarr es modular, permitiendo a los usuarios activar solo las funciones que necesitan.
Gracias a su interfaz basada en la web, Dolibarr se puede utilizar desde cualquier dispositivo con acceso a navegador. Puede instalarse localmente en un ordenador, en un servidor o utilizarse a través de proveedores en la nube.
En esta guía te mostramos paso a paso cómo instalar y configurar Dolibarr.
Requisitos previos
Antes de comenzar, asegúrate de tener:
-
Un servidor o equipo local con Linux (Ubuntu), Windows o macOS
-
Servidor web Apache (o Nginx)
-
Base de datos MySQL o MariaDB
-
PHP 7.0 o superior
-
Acceso administrativo para instalar paquetes y configurar el servidor
Configuración de servidor recomendada:
-
Linux (Ubuntu 20.04+)
-
Apache 2.4+
-
PHP 8.0+
-
MySQL 5.7+ o MariaDB 10.5+
Para instalaciones en Windows se recomienda XAMPP o WAMP.
Paso 1: Descargar Dolibarr
La última versión estable de Dolibarr está disponible en la web oficial:
Elige la versión adecuada para tu sistema operativo. Puedes descargar el paquete "estándar" para instalación manual o utilizar instaladores automáticos para Windows y macOS.
Para obtener la versión más reciente en desarrollo, puedes clonar el repositorio de GitHub:
git clone https://github.com/Dolibarr/dolibarr.git
Para entornos de producción, utiliza solo versiones estables.
Paso 2: Preparar el entorno
En Ubuntu/Linux
-
Actualizar el sistema:
sudo apt update && sudo apt upgrade -y
-
Instalar Apache, MySQL, PHP y los módulos PHP necesarios:
sudo apt install apache2 mysql-server php php-mysql libapache2-mod-php php-cli php-gd php-curl php-intl php-mbstring php-soap php-xml php-xmlrpc php-zip php-bcmath unzip -y
-
Asegurar la instalación de MySQL:
sudo mysql_secure_installation
Sigue las instrucciones para establecer una contraseña root y eliminar configuraciones inseguras.
-
Crear base de datos para Dolibarr:
sudo mysql -u root -p
CREATE DATABASE dolibarr CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'dolibarruser'@'localhost' IDENTIFIED BY 'contraseñasegura';
GRANT ALL PRIVILEGES ON dolibarr.* TO 'dolibarruser'@'localhost';
FLUSH PRIVILEGES;
EXIT;
-
Mover los archivos de Dolibarr al directorio del servidor web:
sudo unzip dolibarr-*.zip -d /var/www/html/
sudo mv /var/www/html/dolibarr-*/ /var/www/html/dolibarr
sudo chown -R www-data:www-data /var/www/html/dolibarr
sudo chmod -R 755 /var/www/html/dolibarr
-
Configurar Apache: Crear un nuevo archivo de configuración para el host virtual:
sudo nano /etc/apache2/sites-available/dolibarr.conf
Agregar:
<VirtualHost *:80>
ServerAdmin admin@example.com
DocumentRoot /var/www/html/dolibarr/htdocs
ServerName ejemplo.com
<Directory /var/www/html/dolibarr/htdocs>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Require all granted
</Directory>
ErrorLog ${APACHE_LOG_DIR}/dolibarr_error.log
CustomLog ${APACHE_LOG_DIR}/dolibarr_access.log combined
</VirtualHost>
Activar el sitio y el módulo rewrite:
sudo a2ensite dolibarr.conf
sudo a2enmod rewrite
sudo systemctl reload apache2
-
Acceder a Dolibarr desde el navegador: Visita
http://tu-ip-servidor/
ohttp://tu-dominio/
para iniciar el asistente de instalación.
En Windows (con XAMPP)
-
Descargar e instalar XAMPP desde https://www.apachefriends.org/.
-
Iniciar Apache y MySQL desde el panel de control de XAMPP.
-
Copiar la carpeta de Dolibarr en
C:\xampp\htdocs\
. -
Crear la base de datos desde phpMyAdmin (http://localhost/phpmyadmin).
-
Acceder a
http://localhost/dolibarr/htdocs
desde el navegador. -
Seguir el asistente de instalación.
En macOS (con MAMP)
-
Descargar e instalar MAMP desde https://www.mamp.info/.
-
Copiar los archivos de Dolibarr en
/Applications/MAMP/htdocs/
. -
Iniciar los servidores MAMP.
-
Crear la base de datos desde phpMyAdmin.
-
Acceder a
http://localhost:8888/dolibarr/htdocs
en el navegador.
Paso 3: Ejecutar el asistente de instalación
Sigue las instrucciones:
-
Seleccionar idioma: Elegir el idioma deseado.
-
Revisión del sistema: Se verificarán los requisitos.
-
Configuración de la base de datos:
-
Servidor:
localhost
-
Nombre de la base:
dolibarr
-
Usuario:
dolibarruser
-
Contraseña:
tucontraseña
-
-
Crear tablas: Haz clic en "Siguiente".
-
Cuenta de administrador: Establecer nombre de usuario y contraseña.
-
Finalizar: Eliminar el directorio de instalación:
sudo rm -rf /var/www/html/dolibarr/htdocs/install
Paso 4: Configuración básica tras la instalación
Tras iniciar sesión:
Configurar datos de la empresa
Ir a Inicio > Configuración > Empresa/Organización e ingresar:
-
Nombre de la empresa
-
Dirección
-
País
-
Moneda
-
Número de IVA (si corresponde)
-
Subir el logo
Activar/Desactivar módulos
Ir a Inicio > Configuración > Módulos/Aplicaciones para:
-
Activar los módulos necesarios (Facturación, Proyectos, Productos, etc.)
-
Desactivar los no necesarios.
Gest### Gest\u00ión de usuarios
-
Añadir usuarios desde Inicio > Usuarios y Grupos.
-
Asignar permisos según roles.
-
Crear grupos para mejor organización.
Paso 5: Asegurar Dolibarr
Buenas prácticas de seguridad:
-
Forzar HTTPS: Instalar certificado SSL.
-
Contraseñas fuertes: Obligatorias para todos los usuarios.
-
Copias de seguridad regulares: Base de datos y archivos.
-
Acceso de administrador limitado: Solo personal de confianza.
-
Actualizaciones regulares: Para evitar vulnerabilidades.
Ajustar permisos de archivos:
sudo find /var/www/html/dolibarr/ -type f -exec chmod 644 {} \;
sudo find /var/www/html/dolibarr/ -type d -exec chmod 755 {} \;
Paso 6: Errores comunes y soluciones
Pantalla blanca al instalar
-
Revisar los registros de errores de Apache.
-
Instalar módulos PHP faltantes.
Problemas de conexión a la base de datos
-
Verificar credenciales.
-
Asegurarse que MySQL esté activo.
Errores de permisos
-
Revisar propietarios y permisos de archivos.
Error 500
-
Revisar problemas de
.htaccess
o configuraciones PHP.
Paso 7: Optimizar Dolibarr
-
Activar caché en Apache.
-
Optimizar configuraciones de MySQL (buffers, cachés).
-
Usar CDN para archivos estáticos.
-
Activar solo los módulos necesarios.
-
Limpiar datos antiguos regularmente.
Conclusión
Instalar y configurar Dolibarr ERP/CRM es sencillo siguiendo un método estructurado. Ya sea que seas un trabajador autónomo o una PYME en crecimiento, Dolibarr se adapta con flexibilidad.
Con esta guía paso a paso tendrás una instalación funcional lista para apoyar tu operación empresarial.
Recuerda: la instalación es solo el inicio. Dedica tiempo a la configuración, capacitación de usuarios y mantenimiento continuo para aprovechar al máximo Dolibarr.
Si planeas un uso intensivo, considera contratar hosting profesional o asistencia especializada.