Instalar Dolibarr con Docker
Sigue la guía de los stacks de Docker para instalar Dolibarr con nuestro stack y ten en cuenta lo propio de esta plataforma. El detalle completo está en el README del repositorio.
Recursos
El primer docker compose up -d construye la imagen de Dolibarr (se compilan las extensiones de PHP), por lo que tarda más que los siguientes arranques.
En reposo el stack usa unos 16 MiB en Caddy, unos 35 MiB en PHP-FPM y unos 200 MiB en MariaDB; cron y backup usan alrededor de 1 MiB entre ejecuciones.
Variables obligatorias
| Variable | Qué debe contener |
|---|---|
DOLI_URL |
URL pública de Dolibarr, por ejemplo https://erp.example.com. |
SITE_ADDRESS |
El dominio de Dolibarr, por ejemplo erp.example.com. |
DB_PASSWORD y DB_ROOT_PASSWORD |
Contraseñas de la base de datos. |
DOLI_ADMIN_PASSWORD |
Contraseña del administrador de Dolibarr. |
SMTP_HOST |
Recomendada: el stack arranca sin ella, pero la plataforma no podrá enviar correos. Servidor SMTP. Completa también SMTP_PORT, SMTP_SECURE, SMTP_USER, SMTP_PASSWORD y SMTP_FROM según tu proveedor (por defecto, puerto 587 con SMTP_SECURE=tls). |
Cuando SMTP_HOST tiene valor, la configuración de correo de Dolibarr se reemplaza con los valores SMTP_* en cada arranque.
Configuración inicial de la empresa
Dolibarr se crea configurado para Chile (idioma es_CL, país CL y moneda CLP). Si operas en otro país, cambia DOLI_LANG, DOLI_COUNTRY y DOLI_CURRENCY, y el nombre de la empresa en DOLI_COMPANY_NAME, antes del primer arranque: estos valores solo se aplican en la instalación inicial y después se modifican desde Dolibarr.
La zona horaria de PHP (date.timezone) se define con PHP_TIMEZONE (por defecto America/Santiago) y se aplica en cada arranque.
Acceso
Cuando setup termina, Dolibarr queda disponible en tu dominio con el usuario admin (configurable con DOLI_ADMIN_LOGIN). Es un nombre de usuario, no un correo.
DOLI_ADMIN_LOGIN y DOLI_ADMIN_PASSWORD solo los usa el instalador: cambiarlos después en el .env no modifica la cuenta (hazlo desde Dolibarr). DOLI_ADMIN_LOGIN es además el usuario con el que el servicio cron ejecuta las tareas programadas, así que debe seguir siendo un usuario existente.
Actualizaciones
Dolibarr se actualiza cambiando DOLI_VERSION en el .env y ejecutando docker compose up -d. Respalda antes. setup sincroniza el código de la nueva versión (conservando htdocs/conf y htdocs/custom) y ejecuta los scripts de actualización de la base de datos de Dolibarr.
Junto con la versión, indica en DOLI_SHA256 el SHA-256 del archivo de esa versión, o déjalo vacío para no verificarlo. Durante la migración aparecen errores “no such table” y “duplicate column” de módulos que no están activos: es normal, Dolibarr los tolera.
Restaurar un respaldo
Los respaldos incluyen la base de datos y un archivo con los documentos, htdocs/conf (configuración) y htdocs/custom (módulos). Para restaurar uno:
docker compose stop dolibarr cron
docker compose run --rm --no-deps backup restore <fecha>
docker compose start dolibarr cron
Notas
- El archivo
conf.phpse genera desde el.enven cada arranque: cambia el.env, no el archivo. - El instalador web (
/install) está bloqueado; la instalación y las actualizaciones las hacesetup. - Algunas funciones de PHP están deshabilitadas por seguridad, por lo que la página de respaldo de base de datos de Dolibarr no funciona: usa el servicio
backup. - Las extensiones IMAP y LDAP de PHP no están incluidas (colector de correo con la extensión nativa y autenticación LDAP).
Siguiente paso
Con Dolibarr funcionando, instala el plugin de BillMySales y conéctalo a tu pasarela de facturación siguiendo la configuración inicial.