Pourquoi héberger Dolibarr sur un VPS ?
Opter pour un VPS plutôt qu'un hébergement mutualisé ou un SaaS vous garantit des ressources dédiées, une base de données isolée et la liberté d'installer les modules Dolibarr de votre choix sans restriction. Vos données restent sur un serveur que vous contrôlez entièrement, conformément aux exigences de confidentialité imposées par les réglementations en vigueur. Un VPS vous permet également de faire évoluer les ressources (RAM, CPU, stockage) à mesure que votre activité se développe, sans jamais migrer de plateforme.
Ce que vous pouvez faire avec Dolibarr
- Créer et envoyer des devis et factures professionnels directement depuis votre navigateur
- Gérer votre carnet de clients et fournisseurs avec historique complet des interactions
- Suivre vos stocks, commandes et livraisons en temps réel
- Piloter vos projets avec jalons, tâches et suivi du temps passé
- Générer des rapports comptables et des tableaux de bord financiers
- Étendre les fonctionnalités via plus de 1 000 modules officiels et communautaires
Prérequis chiffrés avant de dimensionner le VPS
Le wiki Dolibarr demande au minimum MariaDB 10.3, MySQL 5.7.7 ou PostgreSQL 9.1, ainsi qu'un PHP autorisé à utiliser 128 Mo de mémoire (paramètre memory_limit) avec les sessions activées. La page des versions indique que Dolibarr 24.0, publié le 20 août 2026, fonctionne avec un PHP compris entre 7.2 et 8.5 ; Dolibarr 23.0 couvre la même plage, et Dolibarr 22.0 va de 7.1 à 8.4. Sur votre VPS, vérifiez ce que l'installation 1-clic a réellement posé avec php -v et mariadb --version avant d'ajouter un module tiers qui exige une version précise. Les 2 vCPU et 2 Go de RAM de la première étape suffisent pour démarrer une PME ; la mémoire monte avec le nombre d'utilisateurs simultanés, les modules actifs et la génération de PDF. Relevez free -h pendant une journée de facturation avant de changer d'offre : c'est la mesure qui décide, pas l'intuition.
Installer Dolibarr sur votre VPS ServOrbit
Commander un VPS Cloud ServOrbit
Rendez-vous sur la page /vps-cloud et choisissez l'offre adaptée à votre charge : pour une utilisation PME standard de Dolibarr, un VPS avec 2 vCPU et 2 Go de RAM est un bon point de départ. Finalisez la commande ; votre serveur est livré sous 60 secondes avec une adresse IP dédiée et un accès SSH root.
Accéder au Marketplace dans l'espace client
Connectez-vous à votre espace client ServOrbit, ouvrez la fiche de votre VPS, puis cliquez sur l'onglet « Marketplace ». Cette section liste toutes les applications disponibles en installation 1-clic, préconfigurées et prêtes à l'emploi.
Lancer l'installation de Dolibarr
Recherchez « Dolibarr » dans le Marketplace, cliquez sur la fiche de l'application puis sur « Installer ». Le système déploie automatiquement Apache, MariaDB et Dolibarr sur votre VPS. L'opération dure environ 2 à 3 minutes ; vous recevrez une notification dès que l'installation est terminée.
Accéder à l'interface d'installation de Dolibarr
Une fois l'installation terminée, ouvrez votre navigateur et saisissez l'adresse http://VOTRE_IP/dolibarr/install. L'assistant de configuration de Dolibarr vous guide pour créer la base de données, définir l'identifiant et le mot de passe de l'administrateur, puis choisir la langue et la devise. À l'issue de cet assistant, supprimez ou renommez le dossier install/ pour sécuriser votre instance.
Première connexion et configuration initiale
Rendez-vous sur http://VOTRE_IP/dolibarr et connectez-vous avec les identifiants administrateur que vous venez de définir. Depuis le tableau de bord, activez les modules dont vous avez besoin (Factures, Devis, Tiers, Stock, etc.) via le menu Accueil > Configuration > Modules. Pour un accès sécurisé en production, configurez un nom de domaine pointant vers votre VPS et activez un certificat HTTPS via Let's Encrypt.
Se connecter la première fois
Dolibarr s'installe tout seul au premier démarrage : à l'ouverture de l'adresse vous arrivez directement sur l'écran de connexion, sans assistant. Connectez-vous avec l'identifiant « admin » et le mot de passe qui vous a été transmis (retrouvable dans la section Applications de votre espace client), puis changez-le depuis Accueil ▸ Utilisateurs.
Durcir l'instance après la première connexion
- HTTPS partout — rattachez un domaine tel que
votre-domaine.comau VPS, activez le certificat Let's Encrypt et redirigez le HTTP vers le HTTPS : Dolibarr contient vos clients, vos factures et leurs coordonnées - Fichier de configuration en lecture seule —
conf/conf.phpporte les identifiants de la base ; après l'installation, retirez-lui les droits d'écriture avecchmod 400 conf/conf.php - Dossier documents/ non servi par le web — vérifiez qu'une adresse directe vers une pièce jointe ou un PDF de facture ne répond pas sans connexion
- Comptes nominatifs — changez le mot de passe du compte « admin », créez un compte par utilisateur et ne gardez les droits d'administration qu'à ceux qui en ont besoin
- Pare-feu minimal — n'ouvrez que les ports 80 et 443 au public, et limitez le SSH à vos adresses de travail
Avant de mettre Dolibarr en production, planifiez des sauvegardes automatiques de votre base de données MariaDB avec mysqldump et stockez-les hors du VPS (par exemple via un stockage objet distant). Dolibarr stocke également des fichiers uploadés dans le dossier documents/ : incluez ce répertoire dans votre plan de sauvegarde pour ne perdre aucune pièce jointe ni aucun PDF de facture généré.
Mettre à jour Dolibarr sans perdre de données
Les dépôts officiels montrent que la branche 24 compte déjà deux publications : 24.0.0 le 20 août 2026, puis 24.0.1 le 7 septembre 2026. Une mise à jour mineure corrige des défauts ; un changement de version majeure peut modifier la base et relever la version de PHP exigée. Avant toute opération, sauvegardez la base avec mysqldump, copiez le dossier documents/ et le fichier conf/conf.php, puis rejouez la mise à jour sur une copie du VPS ou sur un instantané. Contrôlez ensuite que votre version de PHP reste dans la plage annoncée pour la version cible : un saut de Dolibarr 22.0 vers 24.0 déplace la borne haute de 8.4 à 8.5 et la borne basse de 7.1 à 7.2. Lisez enfin les notes de version avant de lancer l'assistant de mise à niveau, et notez la version installée à côté de votre sauvegarde.
Alerte PHP du 21 octobre 2026
Le 21 octobre 2026, le projet PHP a publié les versions 8.5.12, 8.4.27, 8.3.36 et 8.2.35 pour corriger deux failles critiques, CVE-2026-109618 et CVE-2026-109619, qui peuvent permettre une exécution de code à distance sans authentification. L'avis précise que la mise à jour est le correctif recommandé et que les contournements provisoires ne rendent pas une installation sûre. Sur votre VPS, php -v donne la version, mais les distributions reportent les correctifs sans toujours changer le numéro : consultez l'avis de votre distribution, appliquez les paquets, puis redémarrez Apache ou PHP-FPM. Si Dolibarr tourne dans une image Docker php:*, reconstruisez l'image puis relancez avec docker compose pull && docker compose up -d. Dolibarr 24.0 accepte PHP jusqu'à 8.5, la version 8.5.12 reste donc dans sa plage.
Dolibarr et Stripe : quand un paiement encaissé n'apparaît pas
Si vous encaissez par carte via le module Stripe, un point mérite votre attention. Le ticket n° 32510 du dépôt Dolibarr, ouvert le 3 janvier 2025 sous l'étiquette Bug et toujours ouvert au 31 octobre 2026, décrit un paiement terminé et versé côté Stripe, alors que Dolibarr n'a créé ni la facture, ni sa validation, ni le règlement, après quatre tentatives du client. L'auteur y revient en septembre 2025 : deux factures sur vingt-cinq touchées, avec Dolibarr 21.0.1, puis un nouveau cas en 2026. Le fil compte quinze commentaires, aucun d'un membre de l'organisation Dolibarr, et aucun correctif n'y est annoncé. Voici ce que l'on peut affirmer, et ce qui reste du domaine de l'hypothèse.
Ce que le code montre, ce que les participants rapportent
- Constaté dans le code, branche 24.0 — dans
htdocs/public/stripe/ipn.php, la voie « carte » construit la requête qui passetraiteà 1, la journalise avec le texte « TODO update flag traite to 1 sql= », puis la laisse en commentaire (//$db->query($sql);) ; la requête filtre aussi sursourcetype = 'facture' - Constaté dans le code, branches 22.0 et 23.0 — la même voie ne contient aucune requête, seulement les journaux « TODO update flag traite to 1 » : une valeur
traite = 0ne prouve donc rien sur un paiement par carte - Rapporté par un participant, non confirmé — le règlement par carte serait enregistré par
public/payment/paymentok.phpau retour du navigateur de l'acheteur ; s'il ferme l'onglet ou perd la connexion, le webhook ne répare rien. L'auteur du ticket n'a pas pu confirmer cette piste - Rapporté par un autre participant, non confirmé — pour un paiement manquant, aucune requête
POSTversnewpayment.phpni appel àpaymentok.phpn'apparaît dans les journaux du serveur web après la tentative réussie - Non établi — la cause exacte chez l'auteur du ticket, la décision des mainteneurs sur un correctif, et le lien éventuel avec le ticket n° 32500, où le même auteur décrit une facture non validée malgré un paiement complet
Quelle source dit quoi quand un paiement manque
Faites défiler le tableau
| Source | Ce qu'elle prouve | Ce qu'elle ne prouve pas |
|---|---|---|
| Tableau de bord Stripe | Le paiement est réussi et versé | Que Dolibarr l'a enregistré |
| Colonne `traite` de `llx_prelevement_demande` | Rien sur la voie carte d'après le code des branches 22.0 à 24.0 | Que le webhook est arrivé ou non |
| Table `llx_paiement`, colonne `ext_payment_id` | Qu'un règlement existe côté Dolibarr | Un règlement absent se repère par l'absence de ligne |
| Journaux du serveur web | Si Stripe a appelé le webhook et si le navigateur de l'acheteur est revenu | Pourquoi le règlement n'a pas été créé |
Dépannage : retrouver un paiement Stripe absent de Dolibarr
Lister les paiements réussis côté Stripe
Dans le tableau de bord Stripe, filtrez les paiements réussis de la période et notez leurs identifiants, qui commencent par
pi_. C'est la liste de référence : Dolibarr ne peut pas vous dire ce qu'il n'a jamais reçu.Chercher les demandes sans règlement côté Dolibarr
Sur une copie de la base ou en lecture seule, un participant du ticket propose cette requête, à adapter si votre préfixe de tables n'est pas
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;Chaque ligne est un paiement que Dolibarr a préparé sans jamais l'enregistrer ; croisez ses identifiantspi_avec ceux de Stripe pour ne garder que les paiements réellement réussis.Vérifier que le webhook répond depuis l'extérieur
Depuis un poste extérieur au VPS, lancez
curl -s -o /dev/null -w '%{http_code}' -X POST https://votre-domaine.com/public/stripe/ipn.php. Une réponse 400 prouve que le script s'exécute ; un 404, un 502 ou un délai dépassé désignent le serveur web, le pare-feu ou le CDN. Le code renvoie notamment « Error: Setup of module Stripe not complete for mode StripeLive. The WEBHOOK_KEY is not defined. » quand la clé du webhook manque dans la configuration du module, et « Invalid signature. May be a hook for an event created by another Stripe env or a hack attempt ? Check setup of your keys whsec_... » quand la signature ne correspond pas à la clé enregistrée. Un 400 ne prouve pas que Stripe signe avec la bonne clé : la liste des envois du tableau de bord Stripe le confirme.Lire les journaux du serveur web à l'heure du paiement
Cherchez, pour l'heure du paiement manquant, les appels de Stripe vers
ipn.php, puis les requêtes de l'acheteur versnewpayment.phpetpaymentok.php. Selon les participants du ticket, l'absence de ces deux dernières expliquerait un règlement jamais créé. Gardez-le comme une piste, pas comme un diagnostic.Régulariser et tracer
Depuis la fiche de la facture, saisissez le règlement manquant en reportant l'identifiant Stripe dans la note, validez la facture si elle ne l'est pas, puis consignez l'incident avec la date et le montant. Cette trace sert à comparer le nombre de cas d'un mois à l'autre.
Un rapprochement chaque semaine
Tant qu'aucun correctif n'est annoncé par les mainteneurs, la parade fiable est le contrôle : une fois par semaine, comparez les paiements réussis du tableau de bord Stripe aux règlements de Dolibarr, puis lisez les journaux de réception du webhook. Cette habitude protège aussi votre suivi de trésorerie, puisqu'un encaissement absent de l'ERP fausse le solde attendu. N'annoncez à vos clients aucune cause tant qu'elle n'est pas établie.
La documentation officielle
Pour la configuration avancée, les options propres à l’outil et les changements de version, référez-vous à la documentation officielle de Dolibarr. Ce guide couvre la mise en ligne sur VPS ServOrbit ; la documentation éditeur reste la référence pour les réglages fins.
