¿Por qué alojar Dolibarr en un VPS?
Optar por un VPS en lugar de un alojamiento compartido o un SaaS le garantiza recursos dedicados, una base de datos aislada y la libertad de instalar los módulos de Dolibarr que quiera, sin restricciones. Sus datos permanecen en un servidor que usted controla por completo, conforme a las exigencias de confidencialidad que imponen las normativas vigentes. Un VPS también le permite ampliar los recursos (RAM, CPU, almacenamiento) a medida que su actividad se desarrolla, sin tener que migrar nunca de plataforma.
Lo que puede hacer con Dolibarr
- Crear y enviar presupuestos y facturas profesionales directamente desde su navegador
- Gestionar su cartera de clientes y proveedores con el historial completo de las interacciones
- Seguir sus existencias, pedidos y entregas en tiempo real
- Dirigir sus proyectos con hitos, tareas y seguimiento del tiempo dedicado
- Generar informes contables y cuadros de mando financieros
- Ampliar las funcionalidades con más de 1 000 módulos oficiales y comunitarios
Requisitos cifrados antes de dimensionar el VPS
El wiki de Dolibarr pide como mínimo MariaDB 10.3, MySQL 5.7.7 o PostgreSQL 9.1, además de un PHP autorizado a usar 128 MB de memoria (el parámetro memory_limit) con las sesiones activadas. La página de versiones indica que Dolibarr 24.0, publicado el 20 de agosto de 2026, funciona con un PHP entre 7.2 y 8.5; Dolibarr 23.0 cubre el mismo intervalo y Dolibarr 22.0 va de 7.1 a 8.4. En su VPS, compruebe con php -v y mariadb --version lo que la instalación en 1 clic ha dejado realmente antes de añadir un módulo de terceros que exija una versión concreta. Los 2 vCPU y 2 GB de RAM del primer paso bastan para arrancar una pyme; la memoria crece con el número de usuarios simultáneos, los módulos activos y la generación de PDF. Anote free -h durante una jornada de facturación antes de cambiar de oferta: decide la medición, no la intuición.
Instalar Dolibarr en su VPS ServOrbit
Pedir un VPS Cloud ServOrbit
Vaya a la página /vps-cloud y elija la oferta adaptada a su carga: para un uso estándar de Dolibarr en una pyme, un VPS con 2 vCPU y 2 GB de RAM es un buen punto de partida. Finalice el pedido; su servidor se entrega en menos de 60 segundos, con una dirección IP dedicada y acceso SSH root.
Acceder al Marketplace desde el área de cliente
Inicie sesión en su área de cliente ServOrbit, abra la ficha de su VPS y haga clic en la pestaña «Marketplace». Esta sección lista todas las aplicaciones disponibles con instalación en 1 clic, preconfiguradas y listas para usar.
Iniciar la instalación de Dolibarr
Busque «Dolibarr» en el Marketplace, haga clic en la ficha de la aplicación y luego en «Instalar». El sistema despliega automáticamente Apache, MariaDB y Dolibarr en su VPS. La operación dura entre 2 y 3 minutos; recibirá una notificación en cuanto la instalación haya terminado.
Acceder al asistente de instalación de Dolibarr
Cuando la instalación haya terminado, abra su navegador e introduzca la dirección http://SU_IP/dolibarr/install. El asistente de configuración de Dolibarr le guía para crear la base de datos, definir el identificador y la contraseña del administrador y elegir el idioma y la moneda. Al terminar el asistente, elimine o renombre la carpeta install/ para asegurar su instancia.
Primera conexión y configuración inicial
Vaya a http://SU_IP/dolibarr e inicie sesión con las credenciales de administrador que acaba de definir. Desde el panel, active los módulos que necesite (Facturas, Presupuestos, Terceros, Existencias, etc.) en el menú Inicio > Configuración > Módulos. Para un acceso seguro en producción, configure un nombre de dominio que apunte a su VPS y active un certificado HTTPS con Let's Encrypt.
Conectarse por primera vez
Dolibarr se instala solo en el primer arranque: al abrir la dirección llega directamente a la pantalla de inicio de sesión, sin asistente. Conéctese con el identificador «admin» y la contraseña que se le ha comunicado (disponible en la sección Aplicaciones de su área de cliente), y cámbiela desde Inicio ▸ Usuarios.
Reforzar la instancia tras la primera conexión
- HTTPS en todas partes — asocie un dominio como
su-dominio.comal VPS, active el certificado Let's Encrypt y redirija el HTTP al HTTPS: Dolibarr contiene sus clientes, sus facturas y sus datos - Archivo de configuración de solo lectura —
conf/conf.phpguarda las credenciales de la base de datos; tras la instalación, quítele el permiso de escritura conchmod 400 conf/conf.php - Carpeta documents/ no servida por la web — compruebe que una dirección directa a un adjunto o a un PDF de factura no responde sin iniciar sesión
- Cuentas nominativas — cambie la contraseña de la cuenta «admin», cree una cuenta por usuario y reserve los derechos de administración a quien los necesite
- Cortafuegos mínimo — abra al público solo los puertos 80 y 443 y limite el SSH a sus direcciones de trabajo
Antes de poner Dolibarr en producción, programe copias de seguridad automáticas de su base de datos MariaDB con mysqldump y guárdelas fuera del VPS (por ejemplo en un almacenamiento de objetos remoto). Dolibarr guarda además los archivos subidos en la carpeta documents/: incluya ese directorio en su plan de copias de seguridad para no perder ningún adjunto ni ningún PDF de factura generado.
Actualizar Dolibarr sin perder datos
Los repositorios oficiales muestran que la rama 24 ya cuenta con dos publicaciones: 24.0.0 el 20 de agosto de 2026 y 24.0.1 el 7 de septiembre de 2026. Una actualización menor corrige defectos; un cambio de versión mayor puede modificar la base de datos y elevar la versión de PHP exigida. Antes de cualquier operación, haga una copia de la base con mysqldump, copie la carpeta documents/ y el archivo conf/conf.php, y repita la actualización en una copia del VPS o en una instantánea. Compruebe después que su versión de PHP sigue dentro del intervalo anunciado para la versión de destino: pasar de Dolibarr 22.0 a 24.0 desplaza el límite superior de 8.4 a 8.5 y el inferior de 7.1 a 7.2. Por último, lea las notas de la versión antes de lanzar el asistente de actualización y anote la versión instalada junto a su copia de seguridad.
Alerta de PHP del 21 de octubre de 2026
El 21 de octubre de 2026, el proyecto PHP publicó las versiones 8.5.12, 8.4.27, 8.3.36 y 8.2.35 para corregir dos fallos críticos, CVE-2026-109618 y CVE-2026-109619, que pueden permitir la ejecución remota de código sin autenticación. El aviso precisa que actualizar es la corrección recomendada y que las mitigaciones provisionales no hacen segura una instalación. En su VPS, php -v indica la versión, pero las distribuciones trasladan las correcciones sin cambiar siempre el número: consulte el aviso de su distribución, aplique los paquetes y reinicie Apache o PHP-FPM. Si Dolibarr funciona en una imagen Docker php:*, reconstruya la imagen y reinicie con docker compose pull && docker compose up -d. Dolibarr 24.0 acepta PHP hasta 8.5, así que la versión 8.5.12 sigue dentro de su intervalo.
Dolibarr y Stripe: cuando un pago cobrado no aparece
Si cobra con tarjeta mediante el módulo Stripe, hay un punto que merece su atención. La incidencia n.º 32510 del repositorio de Dolibarr, abierta el 3 de enero de 2025 con la etiqueta Bug y todavía abierta el 31 de octubre de 2026, describe un pago terminado y abonado en Stripe, mientras que Dolibarr no creó ni la factura, ni su validación, ni el pago, tras cuatro intentos del cliente. El autor volvió en septiembre de 2025: dos facturas de veinticinco afectadas, con Dolibarr 21.0.1, y después un nuevo caso en 2026. El hilo reúne quince comentarios, ninguno de un miembro de la organización Dolibarr, y no anuncia ninguna corrección. Esto es lo que se puede afirmar y lo que sigue siendo una hipótesis.
Lo que muestra el código, lo que cuentan los participantes
- Comprobado en el código, rama 24.0 — en
htdocs/public/stripe/ipn.php, la vía «tarjeta» construye la consulta que ponetraitea 1, la registra con el texto «TODO update flag traite to 1 sql=» y la deja comentada (//$db->query($sql);); la consulta filtra además porsourcetype = 'facture' - Comprobado en el código, ramas 22.0 y 23.0 — la misma vía no contiene ninguna consulta, solo los registros «TODO update flag traite to 1»: un valor
traite = 0no prueba nada sobre un pago con tarjeta - Contado por un participante, sin confirmar — el cobro con tarjeta lo registraría
public/payment/paymentok.phpcuando vuelve el navegador del comprador; si cierra la pestaña o pierde la conexión, el webhook no repara nada. El autor de la incidencia no pudo confirmar esta pista - Contado por otro participante, sin confirmar — para un pago ausente, no aparece en los registros del servidor web ninguna petición
POSTanewpayment.phpni llamada apaymentok.phptras el intento logrado - No establecido — la causa exacta en el caso del autor, la decisión de los mantenedores sobre una corrección y la posible relación con la incidencia n.º 32500, donde el mismo autor describe una factura sin validar pese a un pago completo
Qué fuente dice qué cuando falta un pago
Desplace la tabla
| Fuente | Lo que prueba | Lo que no prueba |
|---|---|---|
| Panel de Stripe | El pago se completó y fue abonado | Que Dolibarr lo haya registrado |
| Columna `traite` de `llx_prelevement_demande` | Nada en la vía tarjeta, según el código de las ramas 22.0 a 24.0 | Si el webhook llegó o no |
| Tabla `llx_paiement`, columna `ext_payment_id` | Que existe un pago en Dolibarr | Un pago ausente se detecta por la ausencia de fila |
| Registros del servidor web | Si Stripe llamó al webhook y si el navegador del comprador volvió | Por qué no se creó el pago |
Solución de problemas: encontrar un pago de Stripe ausente en Dolibarr
Listar los pagos logrados en Stripe
En el panel de Stripe, filtre los pagos logrados del periodo y anote sus identificadores, que empiezan por
pi_. Es la lista de referencia: Dolibarr no puede decirle lo que nunca recibió.Buscar las solicitudes sin pago en Dolibarr
Sobre una copia de la base o en solo lectura, un participante de la incidencia propone esta consulta, que debe adaptar si su prefijo de tablas no es
llx_:SELECT pd.rowid, pd.ext_payment_id, pd.sourcetype, pd.fk_facture, pd.amount, pd.date_demande FROM llx_prelevement_demande pd LEFT JOIN llx_paiement p ON p.ext_payment_id LIKE CONCAT(pd.ext_payment_id, '%') WHERE pd.ext_payment_id LIKE 'pi_%' AND pd.ext_payment_site = 'StripeLive' AND p.rowid IS NULL ORDER BY pd.date_demande DESC;Cada fila es un pago que Dolibarr preparó sin registrarlo nunca; cruce sus identificadorespi_con los de Stripe para quedarse solo con los pagos realmente logrados.Comprobar que el webhook responde desde fuera
Desde un equipo externo al VPS, ejecute
curl -s -o /dev/null -w '%{http_code}' -X POST https://su-dominio.com/public/stripe/ipn.php. Una respuesta 400 prueba que el script se ejecuta; un 404, un 502 o un tiempo de espera agotado apuntan al servidor web, al cortafuegos o al CDN. El código devuelve en particular «Error: Setup of module Stripe not complete for mode StripeLive. The WEBHOOK_KEY is not defined.» cuando falta la clave del webhook en la configuración del módulo, y «Invalid signature. May be a hook for an event created by another Stripe env or a hack attempt ? Check setup of your keys whsec_...» cuando la firma no coincide con la clave guardada. Un 400 no prueba que Stripe firme con la clave correcta: la lista de envíos del panel de Stripe lo confirma.Leer los registros del servidor web a la hora del pago
Para la hora del pago ausente, busque las llamadas de Stripe a
ipn.phpy después las peticiones del comprador anewpayment.phpypaymentok.php. Según los participantes de la incidencia, la ausencia de estas dos últimas explicaría un pago nunca creado. Considérelo una pista, no un diagnóstico.Regularizar y dejar constancia
Desde la ficha de la factura, registre el pago ausente anotando el identificador de Stripe en la nota, valide la factura si no lo está y deje constancia del incidente con la fecha y el importe. Ese registro permite comparar el número de casos de un mes a otro.
Una conciliación cada semana
Mientras los mantenedores no anuncien ninguna corrección, la defensa fiable es el control: una vez por semana, compare los pagos logrados del panel de Stripe con los pagos de Dolibarr y lea después los registros de recepción del webhook. Este hábito protege también el seguimiento de su tesorería, ya que un cobro ausente del ERP falsea el saldo esperado. No atribuya a sus clientes ninguna causa mientras no esté establecida.
La documentación oficial
Para la configuración avanzada, las opciones propias de la herramienta y los cambios de versión, consulte la documentación oficial de Dolibarr. Esta guía cubre la puesta en línea en un VPS ServOrbit; la documentación del editor sigue siendo la referencia para los ajustes finos.
