Cómo instalar y configurar Dolibarr ERP/CRM paso a paso
   04/16/2025 00:00:00     Dolibarr    0 Comentarios
Cómo instalar y configurar Dolibarr ERP/CRM paso a paso

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

  1. Actualizar el sistema:

sudo apt update && sudo apt upgrade -y

  1. 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

  1. Asegurar la instalación de MySQL:

sudo mysql_secure_installation

Sigue las instrucciones para establecer una contraseña root y eliminar configuraciones inseguras.

  1. 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;

  1. 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

  1. 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

  1. Acceder a Dolibarr desde el navegador: Visita http://tu-ip-servidor/ o http://tu-dominio/ para iniciar el asistente de instalación.

En Windows (con XAMPP)

  1. Descargar e instalar XAMPP desde https://www.apachefriends.org/.

  2. Iniciar Apache y MySQL desde el panel de control de XAMPP.

  3. Copiar la carpeta de Dolibarr en C:\xampp\htdocs\.

  4. Crear la base de datos desde phpMyAdmin (http://localhost/phpmyadmin).

  5. Acceder a http://localhost/dolibarr/htdocs desde el navegador.

  6. Seguir el asistente de instalación.

En macOS (con MAMP)

  1. Descargar e instalar MAMP desde https://www.mamp.info/.

  2. Copiar los archivos de Dolibarr en /Applications/MAMP/htdocs/.

  3. Iniciar los servidores MAMP.

  4. Crear la base de datos desde phpMyAdmin.

  5. Acceder a http://localhost:8888/dolibarr/htdocs en el navegador.

Paso 3: Ejecutar el asistente de instalación

Sigue las instrucciones:

  1. Seleccionar idioma: Elegir el idioma deseado.

  2. Revisión del sistema: Se verificarán los requisitos.

  3. Configuración de la base de datos:

    • Servidor: localhost

    • Nombre de la base: dolibarr

    • Usuario: dolibarruser

    • Contraseña: tucontraseña

  4. Crear tablas: Haz clic en "Siguiente".

  5. Cuenta de administrador: Establecer nombre de usuario y contraseña.

  6. 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.

Comentarios

Inicia sesión o regístrate para publicar comentarios