---
title: "Instalación con Docker"
description: "Instalar Dolibarr con Docker"
type: "docs"
category: "doc"
tags: []
authors: [Anonymous]
date: "2026-09-25"
last_update: "2026-09-25"
time_minutes: 4
draft: false
unlisted: false
url: "https://www.billmysales.com/docs/datasources/dolibarr/docker"
---

# Instalar Dolibarr con Docker

Sigue la [guía de los stacks de Docker](https://www.billmysales.com/docs/stacks) para instalar Dolibarr con nuestro [stack](https://github.com/BillMySales/billmysales-docker-dolibarr) 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:

```shell
docker compose stop dolibarr cron
docker compose run --rm --no-deps backup restore <fecha>
docker compose start dolibarr cron
```

## Notas

- El archivo `conf.php` se genera desde el `.env` en cada arranque: cambia el `.env`, no el archivo.
- El instalador web (`/install`) está bloqueado; la instalación y las actualizaciones las hace `setup`.
- 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](https://www.billmysales.com/docs/datasources/dolibarr/configuracion-inicial).



---
Última actualización el 25/09/2026