Project Overview
Our client required a safe and reliable upgrade of their existing Dolibarr ERP system from version 12 to the latest stable version 18 (18.0.x). The objective was not only to upgrade the system but also to ensure that all business data, workflows, and customizations remained fully intact while preparing the system for easy upgrades in the future.
The team at CnEL India implemented a structured upgrade strategy that prioritized data protection, minimized operational downtime, and ensured all custom developments were migrated into the recommended /custom/ directory to make future upgrades simple and risk-free.
The Challenge
- Upgrade a live Dolibarr system from v12 to v18 without disrupting ongoing operations.
- Preserve all business data including documents, configurations, and historical records.
- Identify and migrate customizations that were previously implemented in core files.
- Ensure compatibility with the latest Dolibarr architecture and PHP environment.
- Provide a future-proof structure allowing easy upgrades for upcoming Dolibarr versions.
Why CnEL India Was the Best Team for the Project
CnEL India specializes in advanced ERP integrations, custom module development, and enterprise system upgrades. Our structured methodology ensures that complex upgrades are handled with precision and minimal risk.
- Deep Dolibarr Expertise – Extensive experience in Dolibarr customization, module development, and ERP upgrades.
- Zero Data Risk Strategy – Multiple backups and recovery checkpoints to guarantee full system restoration if required.
- Staging-First Deployment – All upgrades and testing performed on staging before production implementation.
- Future-Proof Development – Migration of all customizations into the
/custom/directory for easy upgrades. - Comprehensive Testing – Workflow validation and system testing to ensure seamless functionality.
- Structured Deployment Plan – Planned maintenance window and step-by-step production rollout.
Our Step-by-Step Implementation
1. Assessment & Full Backup
The first phase focused on securing the entire system and preparing the environment for a safe upgrade.
- Verified server compatibility with PHP 8.1+ and MySQL/MariaDB 10.5+.
- Executed a full database backup using mysqldump.
- Archived the complete file system including conf.php, documents, and custom code.
- Stored encrypted backups off-site with a 30-day retention policy.
- Audited all existing customizations across core files and external directories.
2. Staging Setup & Initial Upgrade
To eliminate any production risk, a private staging environment was created.
- Cloned the production system to a secure staging server.
- Installed Dolibarr v18.0.x and merged existing system files.
- Preserved critical directories including conf.php and documents.
- Executed the official Dolibarr upgrade wizard at
/install/. - Validated login functionality, modules, and system navigation.
3. Customization Migration & Testing
This phase ensured that all previous custom work remained fully functional in the upgraded system.
- Migrated existing customizations into /custom/modules/ and related directories.
- Refactored modifications that were previously inside core files.
- Updated third-party modules to Dolibarr v18 compatible versions.
- Performed workflow testing based on the client’s operational processes.
- Provided shared staging access for the client’s team to validate functionality.
4. Production Go-Live
Once the system was fully validated, the final upgrade was deployed to production with minimal downtime.
- Scheduled a 30–60 minute maintenance window.
- Applied the upgrade and migrated customizations to production.
- Cleared caches and secured the installer.
- Performed system monitoring and log verification.
5. Handover & Support
- Delivered complete upgrade documentation.
- Provided a 1-hour training session for the client team.
- Offered 1-week post-launch technical support.
Future-Proof System Architecture
After the upgrade, all customizations were organized within the /custom/ directory, ensuring long-term maintainability and seamless upgrades.
- Future upgrades (v18 → v19 and beyond) can be performed safely.
- Dolibarr’s built-in update system can now handle future patches easily.
- No core file modifications required for future customizations.
Project Timeline
| Week | Focus |
|---|---|
| Week 1 | Backup creation, customization audit, staging setup, initial upgrade |
| Week 2 | Customization migration, module updates, testing |
| Week 3 | Client validation, final testing, production go-live |
Throughout the project, the client received weekly progress updates via email and calls, ensuring full transparency and collaboration.
Project Deliverables
- Complete backup and recovery strategy
- Secure staging environment
- Dolibarr v18 production upgrade
- Customization migration into /custom/
- Third-party module compatibility updates
- Comprehensive system testing
- Deployment, training, and post-launch support
Client Review
“CnEL India handled our Dolibarr upgrade with exceptional professionalism. The entire process was structured, transparent, and completely secure. Our data, customizations, and workflows were preserved perfectly while upgrading to the latest version. Their technical expertise and communication made the project smooth from start to finish. We highly recommend CnEL India for any ERP customization or upgrade work.”
— Project Client
Conclusion
By combining deep Dolibarr expertise with a structured upgrade methodology, CnEL India successfully delivered a secure, seamless, and future-ready ERP upgrade. The client now operates on the latest Dolibarr platform with improved performance, better maintainability, and the ability to upgrade easily in the future.
If your business needs Dolibarr upgrades, custom module development, or ERP integrations, the team at CnEL India is ready to deliver reliable and scalable solutions.