DolicraftUpgrade - One-Click Dolibarr Upgrade & Rollback

DolicraftUpgrade - One-Click Dolibarr Upgrade & Rollback

Upgrade and rollback your Dolibarr instance in one click. No more manual file transfers, risky command-line operations, or hours of downtime. DolicraftUpgrade handles everything: version detection, backup, pre-flight checks, upgrade execution, and automatic rollback if anything goes wrong. Free and open source.

Version Detection

Automatic Version Detection via GitHub API
The module queries the official Dolibarr GitHub repository to detect all available versions. It compares your current installed version with the latest releases and shows available upgrades, including major, minor, and patch versions.

New Version Notification
Get notified directly in your Dolibarr admin area when a new version is available. No need to manually check for updates.

Automatic Backup

Database Backup Before Each Operation
A full database dump is automatically created before every upgrade or rollback. Your data is always safe.

Files Backup Before Each Operation
All Dolibarr core files are backed up automatically before any operation. The backup is stored locally and can be used for manual recovery if needed.

Pre-Upgrade Checks

10 Pre-Upgrade Checks with Auto-Fix
Before any upgrade, the module runs 10 verification checks to ensure your system is ready:

• PHP version compatibility
• Disk space availability
• File permissions (write access)
• Database connection
• Required PHP extensions
• conf.php integrity
• Custom modules compatibility
• Backup directory writable
• Memory limit
• Execution time limit

Issues detected are automatically corrected when possible. Blocking issues prevent the upgrade from starting.

Upgrade & Rollback

One-Click Upgrade
Select the target version and click upgrade. The module downloads the official release from GitHub, extracts it, replaces core files while preserving your configuration, and runs the Dolibarr migration scripts automatically.

One-Click Rollback
If something goes wrong after an upgrade, roll back to the previous version in one click. The module restores the backed-up files and database to the exact state before the upgrade.

Automatic Rollback on Failure
If the upgrade process fails at any step, the module automatically triggers a rollback to restore your previous working state. No manual intervention needed.

Safety Features

Preserves conf.php, documents/ and custom/
Your configuration file (conf.php), uploaded documents (documents/), and custom modules (custom/) are never touched during upgrades. Only Dolibarr core files are replaced.

Maintenance Mode During Operations
The module automatically activates maintenance mode during upgrade and rollback operations. Users see a maintenance page while the operation is in progress. Maintenance mode is deactivated once the operation completes.

Full Update History
Every upgrade and rollback operation is logged with date, source version, target version, status (success/failure), and duration. Complete audit trail of all operations.

Technical Highlights

• 6 languages - French, English, Spanish, German, Italian, Portuguese (BR)
• Dolibarr 16-23 - Compatible with Dolibarr 16 through 23
• PHP 7.4 - 8.3 - Works with all modern PHP versions
• Zero dependencies - No external libraries, pure Dolibarr module
• GPL v3+ - Free and open source
• Standard Dolibarr patterns - Uses hooks, triggers, and standard class architecture

Requirements

• Dolibarr 16.0+
• PHP 7.4 - 8.3 with cURL extension
• Write access to Dolibarr root directory
• Sufficient disk space for backups

Installation

1. Copy to htdocs/custom/dolicraftupgrade/
2. Activate in Home > Setup > Modules
3. Go to DolicraftUpgrade to check for available versions
4. Click Upgrade and let the module handle everything!

Developed by Dolicraft - Professional Dolibarr modules. Support: contact@dolicraft.com