Ghost on GitHub Pages

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.

What's new in version 3

• Simpler setup — Node.js and wget only (no Python)
• Reliable publishing — fixes broken images and localhost links (#9–#22)
• Safe upgrade path — ./migrate.sh with automatic backup from Classic v2
• Plain-English guides in the docs/ folder

Full details: Release notes · Changelog

How your blog gets online

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"]

Loading

Start here

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

Documentation

Step-by-step guides for install, publishing, migration, and more live in docs/README.md.

Community

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).

About

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.

• Download v2.1.0 (latest Classic)
• Legacy documentation
• Classic v2 live demo (archive)