Hey everyone ![]()
As I mentioned back in August, Ghost-CLI is being deprecated and replaced with a new-and-improved Ghost Docker setup.
Today, the docker setup + Ghost-CLI migration path is ready to test for those that want to try it early!
We’d appreciate any feedback from those that want to test it out, to help us iron out any issues before Ghost 7.0.
Highlights
- Documentation: lives on docker.ghost.org and in the repo for the time being - it’ll be moved into the main Ghost Docs once the beta testing/development period is done.
- Installation: now a one-line bash command that sets up the local docker-compose files (for both local and production installs) - no Git required.
ghost-dockerCLI helper: the Docker setup now ships with a lightweight CLI tool to help with automating common maintenance tasks (update,backup,restore,check, etc.) Normal day-to-day use (logs, start, stop, etc) uses the normaldocker composecommands.- Local Installs: now supported with the
--localflag. Add--with mailpitto start a local Mailpit instance for email testing. - Ghost-CLI Migration: Migrating a Ghost-CLI install (both local and production) is supported via Ghost-CLI’s
migrate-exportcommand and the installer’s--importflag. - One-Click Admin Updates: Adding
--with supervisorstarts a supervisor image that enables one-click updates in Ghost Admin (needs Ghost >= 6.72.0, not available under rootless Docker) - Nightly Images: Ghost now publishes a nightly docker image that you can opt into for testing the latest features prior to release. Add
--ghost-channel nightlyto have your install use the nightly image (for testing only - it’s not currently possible to switch between stable and nightly channels)
Testing it out
- Production Setup:
curl -fsSL https://docker.ghost.org/install.sh | bash -s -- install --domain mysite.com - Local Setup:
curl -fsSL https://docker.ghost.org/install.sh | bash -s -- install --local - Migrating a Ghost-CLI site: Ensure you’re on the latest version of Ghost-CLI (>= v1.34.0) and a recent version of Ghost (>= v6.61.0), then run
ghost migrate-export --output <export path>andcurl -fsSL https://docker.ghost.org/install.sh | bash -s -- install --import <export path>(docs) - Migrating from a current ghost-docker main clone: see the docs Note: this will move your site into the beta channel
Beta Caveats
- This new setup is still in beta, and while we don’t expect things to change too dramatically between now and the full release with Ghost 7.0, there still could be breaking changes. That said, those changes will be communicated out if/when they happen.
- Production Sites: This setup should be safe to try for production sites, but make sure to take a backup before switching to the Docker setup. Also, while the
updateandself-updatecommands take automatic backups before running, it’s still worth running./ghost-docker backupyourself and copying it off the server, just in case.
Not Supported Yet
There’s a few things that we’ll be adding to the docker setup before it’s finalized that aren’t ready yet, namely:
- Multi-site installs (multiple Ghost sites behind a shared Caddy instance)
- Smaller optimizations/hardening fixes (file-based secrets, Redis caching, etc)
- (potentially) Native Windows support. Currently on Windows, use WSL2 with Docker Desktop’s WSL integration.
Feedback
Any issues or requests for the new setup should be reported as Github Issues in the ghost-docker repo using the next-docker template. Check the list of open issues with the next-docker label first to ensure the issue hasn’t been reported already ![]()
Questions or general feedback can be submitted as replies in this thread.
Thank you in advance to anyone who’s willing to help test this out, as well as to anyone who’s used and submitted feedback to the current ghost-docker setup in the past.