TryGhost / TryGhost/docker-library-ghost

Documentation on updating Ghost

Open
#309 6 comments 7 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Shell
Stars
796
Forks
319
Avg merge
7h 42m
Merged PRs (30d)
6

Description

With the release of Ghost v5 we have spent quite a lot of time carefully crafting update docs

https://ghost.org/docs/update

However, they are for the recommended install method which is Ghost CLI. We use the CLI to do a lot of the legwork and prevent issues with updates.

With docker, I'm not sure there's any way we can do anything to prevent people updating incorrectly, but it seems there should probably be detailed update docs?

The critical details being:

  1. mysql8 is now the only supported database in production.
  2. updates across majors are only guaranteed to work if you update to the latest version in your major first.

To clarify that last point, if you're on 3.25.9, you need to update Ghost to 3.42.9 - including starting the server to trigger the migrations - before updating to v5.0.0.

Note: you don't have to cycle through every major - you don't have to upgrade to v4 first.

There's absolutely no way to guarantee you can update from any version to any version without data loss or corruption as there can always be bugs that are fixed in later versions 🤷‍♀️

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the existing update guidance at https://ghost.org/docs/update and inspect the docker-library-ghost repository for its current documentation and update instructions. Document Docker-specific upgrades, including MySQL 8 production support and updating to the latest release in the current major with the server started before crossing majors. Done means the guidance also explains that intermediate major versions are not required.

Written by the indexing model from the issue text.

Assessment

Tech stack
docker, mysql
Domain
devops, documentation
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.