Ghost Release: 5.29.0

TL;DR

Ghost v5.29.0 is a maintenance release that addresses email handling issues with Mailgun integration. The update improves how Ghost manages email suppressions by synchronizing with Mailgun's suppression list more accurately, fixing issues where emails were incorrectly added to the suppression table. This release also reverts a dependency update that was causing random high CPU usage issues.

Highlight of the Release

• Improved email suppression handling with Mailgun integration
• Fixed issue where emails were incorrectly added to the suppression table
• Reverted dependency updates that were causing high CPU usage

Migration Guide

No migration steps are required for this release. The update can be applied directly without any additional configuration changes.

Upgrade Recommendations

This release is recommended for all Ghost users, especially those who use Mailgun for email delivery. The improvements to email suppression handling will ensure more reliable email delivery and better synchronization with Mailgun's suppression list. Additionally, the performance fix addressing high CPU usage makes this an important update for maintaining system stability.

Bug Fixes

Email Suppression List Management

• Fixed an issue with MailgunEmailSuppressionList where Ghost was incorrectly adding emails to the suppression table that weren't actually on Mailgun's suppression list
• Updated the suppression handling logic to only add emails to Ghost's suppression list after Mailgun has already added them
• Now properly handles error codes from Mailgun:
  • Code 605 for previous bounces
  • Code 607 for previous spam complaints
• This ensures Ghost's suppression list stays in sync with Mailgun's actual suppression status

New Features

No significant new features were added in this release. The changes focus on bug fixes and performance improvements to existing functionality.

Security Updates

No security fixes were included in this release.

Performance Improvements

System Performance

• Reverted a dependency update that was causing random high CPU usage issues
• This reversion helps maintain stable system performance while the root cause is being investigated
• Reference: TryGhost/Toolbox#501

Impact Summary

Ghost v5.29.0 focuses on improving the reliability of email delivery through better handling of Mailgun's suppression list. The key change is in how Ghost manages email suppressions, now waiting for specific error codes from Mailgun (605 for bounces, 607 for spam complaints) before adding emails to its internal suppression list. This ensures Ghost's suppression table accurately reflects Mailgun's actual suppression status.

The release also addresses a performance issue by reverting a dependency update that was causing random high CPU spikes, improving overall system stability.

While this release doesn't introduce new features, the bug fixes and performance improvements are important for maintaining reliable email delivery and system performance, particularly for sites that heavily rely on newsletter functionality.

Full Release Notes