TL;DR
Ghost v4.48.1: Critical Fix for MariaDB Migration Compatibility
This patch release addresses a critical issue affecting Ghost installations using MariaDB 10.2.7+ that were unable to complete the v4.46 migration process. The update fixes a Knex.js bug that incorrectly fetched column defaults in MariaDB, which was blocking users from updating their Ghost installations. This is an important stability update for MariaDB users.
Highlight of the Release
- Fixed critical migration issue for MariaDB 10.2.7+ users
- Updated Knex.js from v2.0.0 to v2.1.0 to resolve column default detection bug
- Ensured Ghost-CLI tests properly target v4.x releases
Migration Guide
No migration steps are required for this update. This patch release is specifically designed to fix migration issues that were occurring when updating to v4.46+ on MariaDB 10.2.7+ installations.
Simply update to Ghost v4.48.1 using your standard update process:
ghost update
If you were previously blocked from updating due to the MariaDB migration issue, this update should resolve that problem and allow you to complete the update process.
Upgrade Recommendations
Immediate Upgrade Recommended for MariaDB Users
If you're running Ghost on MariaDB 10.2.7+ and have experienced issues updating to v4.46 or later, we strongly recommend upgrading to v4.48.1 immediately.
For all other users, this update is recommended but not critical unless you're experiencing the specific migration issue addressed in this release.
This is a patch release with minimal changes focused on fixing a specific compatibility issue, so the upgrade should be straightforward with no breaking changes.
Bug Fixes
Fixed v4.46 Migration Compatibility with MariaDB
This release addresses a critical issue that prevented Ghost installations using MariaDB 10.2.7+ from completing the v4.46 migration process. The problem was caused by a bug in Knex.js v2.0.0 that incorrectly fetched column default values on MariaDB 10.2.7+.
The fix updates Knex.js from v2.0.0 to v2.1.0, which includes the necessary patch to correctly handle column defaults in MariaDB.
Fixed Ghost-CLI Tests
This release also fixes Ghost-CLI tests on the 4.x branch by hardcoding the test installations to use v4 instead of automatically pulling the latest version (which would now be v5.x).
New Features
No new features were introduced in this patch release. This update focuses exclusively on fixing a critical migration compatibility issue.
Security Updates
No security fixes were included in this patch release.
Performance Improvements
No specific performance improvements were included in this patch release. The focus was on fixing the critical migration compatibility issue with MariaDB.
Impact Summary
This patch release resolves a critical issue that was preventing Ghost installations on MariaDB 10.2.7+ from completing the v4.46 migration process. The fix updates the Knex.js dependency from v2.0.0 to v2.1.0, which corrects how column defaults are fetched in MariaDB.
The impact is primarily positive for MariaDB users who were previously blocked from updating their Ghost installations. After applying this update, affected users should be able to successfully complete the migration process and update to the latest v4.x releases.
This release also includes a minor fix for Ghost-CLI tests to ensure they properly target v4.x releases instead of pulling in v5.x releases during testing.
No new features, performance improvements, or security fixes are included in this release, as it's focused specifically on addressing the MariaDB compatibility issue.
Full Release Notes
- 🐛 Fixed v4.46 migration compatibility with MariaDB - Daniel Lockyer
View the changelogs for full details:
🪄 Love open source? We're hiring Node.js Engineers to work on Ghost full-time