Installation
Install Knot Migration on a staging instance before rolling out to production. The module depends on Knot Core (mandatory).
Requirements
| Component | Minimum | Recommended |
|---|---|---|
| Dolibarr | 20.0.0 | 21.0.x LTS |
| Knot Core | ≥ 2.12.0 | Latest stable release |
| PHP | 8.1 | 8.2 with OPcache |
| Database | MariaDB 10.6 or MySQL 5.7 | MariaDB 11.x |
| Disk | 200 MB under documents/ | 1 GB for snapshots + reports |
Canonical paths
| Item | Location |
|---|---|
| Module on disk | htdocs/custom/knotmigration/ |
| Admin setup | …/custom/knotmigration/admin/setup.php |
| Internal REST API | …/custom/knotmigration/api/ |
The Dolibarr slug is knotmigration (no hyphen), matching modKnotMigration.
Install steps
- Download
knotmigration-X.Y.Z.zipfrom license.knot.tools and verify the published SHA-256. - Enable Knot Core if not already active.
- Deploy the archive via Home → Setup → Modules → Deploy an external module.
- Enable Knot Migration, then open the gear icon → setup page.
- Activate the license before running any diagnostic.
Post-install checks
- The Knot › Migration sidebar entry appears after a valid license.
- Outbound HTTPS to
license.knot.tools(443) succeeds from the server. composer check-platform-reqsreports no PHP blockers.
Next steps
Licensing Activation code and grace period.
First diagnostic Validate the install with a test diagnostic.