Ghost Release: 3.0.1

TL;DR

Ghost 3.0.1 is a maintenance release that addresses several critical bugs from the 3.0.0 release. It fixes migration issues for SQLite databases, resolves proxy setup problems, corrects page template classes, and addresses member export limitations. This release improves stability for users who recently upgraded to Ghost 3.0.0 or are planning to upgrade from earlier versions.

Highlight of the Release

• Fixed migration issues for SQLite databases with large post counts
• Resolved 404 errors when using proxy setups with separated frontend and admin
• Removed list of reserved slugs to allow more flexibility in page creation
• Fixed members export to allow exporting more than 15 members
• Corrected body class output on pages

Migration Guide

If you're upgrading from Ghost 3.0.0, this is a straightforward maintenance release that fixes several bugs and should not require any additional steps beyond the standard update process.

If you're upgrading from a version prior to 2.28.x directly to 3.0.1, this release specifically fixes migration issues that were present in 3.0.0. Follow the standard upgrade process, but be aware that:

1. SQLite users with large databases (>999 posts) should now be able to migrate successfully
2. The migration path from pre-2.28.x versions has been fixed

For users experiencing 404 errors with proxy setups, this release includes fixes that should resolve those issues without requiring additional configuration.

Upgrade Recommendations

Highly recommended for all Ghost 3.0.0 users

This release fixes several critical bugs in Ghost 3.0.0, particularly for users with SQLite databases or proxy setups. If you're currently running Ghost 3.0.0, we strongly recommend upgrading to 3.0.1 as soon as possible.

For users on versions prior to 3.0.0 who were holding off on upgrading due to reported issues, this release addresses many of the initial problems and provides a more stable upgrade path.

Bug Fixes

• Migration Issues

  • Fixed migration path from pre-2.28.x versions directly to 3.0.0
  • Resolved SQLite migration failures when dealing with large numbers of posts (>999)
  • Fixed 3.0/05-populate-posts-meta-table.js and 3.0/11-update-posts-html migrations for SQLite

• Template & Display Issues

  • Fixed incorrect body class output on pages (outputting post-template instead of page-template)
  • Fixed editor showing incorrect domain and "unsaved changes" modal for relative links

• API & Functionality Issues

  • Fixed members export which was previously limited to only 15 members
  • Fixed 404 errors when using proxy setups with separated frontend and admin
  • Resolved "cannot read property 'length' of undefined" error from {{#has}} helper when dependent data was missing

• Casper Theme Fixes

  • Fixed images on infinite scroll index pages being stretched in Safari
  • Improved styling and content display on the 404 page

New Features

• Removed list of reserved slugs, allowing more flexibility in creating pages with previously restricted paths like /signin/
• Updated several dependencies including express-hbs to v2.2.0 and gscan to v3.1.0

Security Updates

No specific security fixes were included in this release.

Performance Improvements

• Optimized SQLite migrations to handle large databases by using iterative methods instead of batch operations
• Switched to using knex directly in migrations rather than depending on the model layer for better performance

Impact Summary

Ghost 3.0.1 is primarily a bug fix release that addresses several critical issues reported after the 3.0.0 release. The most significant improvements are for administrators managing SQLite databases with large post counts and those using proxy setups with separated frontend and admin interfaces.

The removal of reserved slugs provides more flexibility for developers and content creators to structure their sites as needed. This change allows for the creation of pages with paths that were previously restricted, such as /signin/.

For content creators, fixes to the editor and page template classes improve the authoring experience by eliminating incorrect warnings about unsaved changes and ensuring proper styling of pages.

Overall, this release significantly improves the stability and reliability of Ghost 3.0 without introducing major new features or breaking changes.

Full Release Notes