Ghost Release: 1.21.1

TL;DR

Ghost 1.21.1: Critical Migration Fix

This patch release fixes a critical migration issue that affects users upgrading from Ghost versions earlier than 1.13 directly to version 1.21. The bug prevented successful database migrations due to a missing protection against non-existent roles in the database. If you're running a Ghost version older than 1.13 and planning to upgrade to 1.21, you must use this 1.21.1 release instead.

Highlight of the Release

• Fixed critical migration issue when upgrading from Ghost versions earlier than 1.13
• Added protection against non-existent roles in the database during migration
• Updated Ghost-Admin to version 1.21.1

Migration Guide

If you are upgrading from a Ghost version earlier than 1.13:

1. Do not upgrade directly to Ghost 1.21.0
2. Instead, upgrade to Ghost 1.21.1 which contains the necessary fix for the migration process
3. Follow the standard Ghost upgrade process:

   npm install -g ghost-cli@latest
   ghost update
   

If you are already running Ghost 1.13 or newer, you can upgrade to either 1.21.0 or 1.21.1 without issues, though 1.21.1 is recommended.

Upgrade Recommendations

• Critical upgrade for users on Ghost versions earlier than 1.13 who are planning to upgrade to version 1.21
• Recommended upgrade for all users on 1.21.0 for consistency
• Standard upgrade process applies:

  npm install -g ghost-cli@latest
  ghost update
  

This is a small patch release with minimal changes, focused on fixing a specific migration issue. The upgrade process should be quick and straightforward.

Bug Fixes

Migration Fix

Fixed a critical issue in the migration process when upgrading from Ghost versions earlier than 1.13 directly to version 1.21:

• Added protection in the fixture utility against non-existent roles in the database
• Specifically, the utility now handles cases where it tries to fetch the contributor role from the database which does not exist yet during migration
• This prevents the migration process from failing when upgrading from older Ghost installations

New Features

No new features were introduced in this patch release. This is strictly a bug fix release focused on resolving a migration 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 migration issue.

Impact Summary

This release addresses a specific but critical issue affecting users upgrading from older Ghost versions (pre-1.13) to version 1.21. Without this fix, such migrations would fail due to the fixture utility attempting to access contributor roles that don't yet exist in the database during the migration process.

The impact is limited to the upgrade path only - no functionality changes or feature additions are included in this release. For most users already on recent Ghost versions, this update is minor, but for those maintaining older Ghost installations and planning to upgrade, this release is essential to ensure a smooth migration process.

The fix itself is minimal and targeted, adding appropriate protection in the fixture utility to handle cases where certain database roles don't exist yet during migration.

Full Release Notes