Ghost Release: 1.24.1

TL;DR

Ghost 1.24.1: Critical Bugfix Release

This is an urgent bugfix release addressing several critical issues in Ghost 1.24.0, including a server startup problem that caused all URLs to return 404 errors. The update also fixes issues with post redirects, duplicate log entries, and Koenig editor scroll jumps. If you're running Ghost 1.24.0, immediate upgrade is strongly recommended to ensure proper site functionality.

Highlight of the Release

• Fixed critical server startup issue that caused all URLs to return 404 errors
• Fixed post redirects to properly maintain query parameters
• Improved log file management by eliminating duplicate entries
• Enhanced Koenig editor experience by fixing scroll jump issues when selecting cards
• Modified importer to no longer import Slack hooks for security reasons

Migration Guide

Slack Integration After Import

If you're importing data into Ghost, please note that Slack webhook configurations will no longer be imported automatically. After completing your data import, you'll need to manually reconfigure your Slack integrations:

1. Go to Settings > Integrations
2. Click on "Slack" or add a new Slack integration
3. Configure your webhook URL and customize notification settings

No other migration steps are required for this update.

Upgrade Recommendations

Urgent Upgrade Recommended

If you are currently running Ghost 1.24.0, it is strongly recommended to update to 1.24.1 immediately to avoid the critical URL routing issue that causes pages to return 404 errors.

The upgrade process follows the standard Ghost update procedure:

ghost update

Or if using Ghost(Pro), the update will be automatically applied to your site.

This is a patch release with no breaking changes, so the upgrade should be straightforward with no expected compatibility issues.

Bug Fixes

Critical URL Routing Fix

Fixed a timing bug in the Ghost bootstrap process that caused all URLs to return 404 errors after server startup. The issue occurred due to parallel operations during bootstrap:

1. Resources are fetched as early as possible
2. Other operations (express bootstrapping, theme loading, router registration) happen simultaneously

In some cases, the second set of operations would complete too slowly, causing the queue responsible for handling both parallel actions to close prematurely before routers were fully registered.

Post Redirect Improvements

Fixed an issue where query parameters were not being respected during post redirects. This bug caused a 301 redirect that stripped away query parameters, breaking functionality for sites that relied on these parameters. The fix ensures that all query parameters are properly maintained during redirects.

Koenig Editor Enhancements

Fixed a scroll jump issue in the Koenig editor that occurred when selecting cards. This improves the editing experience by maintaining the expected scroll position during content creation and editing.

Log File Optimization

Updated ghost-ignition to version 2.9.3, which fixes an issue with duplicate entries appearing in log files. This reduces log file bloat and makes debugging easier.

New Features

Enhanced Security for Imports

The Ghost importer has been modified to no longer import Slack webhook configurations. This change enhances security by preventing accidental importation of third-party Slack hooks, which could potentially send notifications to unintended recipients. Site administrators will now need to manually reconfigure their Slack integrations after importing data.

Security Updates

No specific security fixes were included in this release. However, the change to no longer import Slack webhooks during data imports does provide an additional layer of security by preventing potential unintended notifications to third parties.

Performance Improvements

Improved Log File Management

The update to [email protected] not only fixes duplicate entries in log files but also improves overall logging performance. This results in smaller log files that are easier to parse and analyze, reducing disk usage and improving system performance during log rotation and analysis tasks.

Impact Summary

Ghost 1.24.1 is a critical bugfix release that addresses several important issues affecting site functionality. The most significant fix resolves a timing issue in the Ghost bootstrap process that could cause all URLs to return 404 errors after server startup. This issue alone makes this update urgent for all Ghost 1.24.0 users.

The release also improves the handling of query parameters in post redirects, fixes scroll jump issues in the Koenig editor, and eliminates duplicate entries in log files. These changes collectively enhance the stability, usability, and performance of Ghost sites.

The only notable change in behavior is that the Ghost importer will no longer import Slack webhook configurations, requiring administrators to manually set up these integrations after importing data. This change improves security by preventing unintended notifications to third parties.

Overall, this release focuses on stability and bug fixes rather than introducing new features, making it a safe and important update for all Ghost users.

Full Release Notes