Home

>

Tools

>

Ghost

>

Releases

>

4.48.1

Ghost Release: 4.48.1

Tag Name: v4.48.1

Release Date: 5/30/2022

Ghost LogoGhost

Open-source publishing platform specifically designed for professional bloggers and publications. Focuses on clean, minimalist writing and publishing experience.

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

Statistics:

File Changed4
Line Additions32
Line Deletions16
Line Changes48
Total Commits4

User Affected:

  • Can now successfully update Ghost installations on MariaDB 10.2.7+ servers
  • No longer experience migration failures when updating from earlier versions to v4.46+

Contributors:

daniellockyer