Write in Ghost. Publish a free blog on GitHub Pages.
No paid hosting. Set up in minutes.
Get started · v3 demo · Upgrading from Classic?
Ghost is a modern publishing platform. This project helps you run Ghost on your computer and publish a free static blog on GitHub Pages — no paid hosting required.
Live demos: v3 (current) · Classic v2 (archive) — see the demo repository for details.
- Simpler setup — Node.js and wget only (no Python)
- Reliable publishing — fixes broken images and localhost links (#9–#22)
- Safe upgrade path —
./migrate.shwith automatic backup from Classic v2 - Plain-English guides in the
docs/folder
Full details: Release notes · Changelog
flowchart LR
edit["Edit in Ghost\nlocalhost:2373"] --> gssg["gssg creates\nstatic files"]
gssg --> github["Push to GitHub"]
github --> live["Live blog on\nGitHub Pages"]
| I want to… | Start here |
|---|---|
| Set up a new blog | Getting Started |
| Upgrade from Classic v2 | Migration guide |
| Fix a problem | Troubleshooting |
| Understand a term | Glossary |
Step-by-step guides for install, publishing, migration, and more live in docs/README.md.
Questions and ideas are welcome — open an issue.
Want to help? You do not need to be a developer. See CONTRIBUTING.md for ways to contribute (docs, bug reports, testing, and code).
Created to make Ghost blogs accessible on free GitHub Pages hosting. Licensed under MIT.
Reference: Free Ghost hosting on GitHub Pages
Using Classic v2 (buster / Python 2)?
Classic is in maintenance on branch classic/v2.