Ghost on Heroku

by shishak


Ghost 2.X on Heroku

Ghost is a free, open, simple blogging platform. Visit the project's website at, or read the docs on


This is a fork with some improvements from I have forked and improved this repository as the original developer seemed to have abandoned his repo recently. In this repository I have upgraded ghost to ghost 2.X and added cloudinary as a free storage alternative to amazon's s3. If you are still interested with the ghost 1.0 version please visit the original repository.

Ghost version 2.X

The latest release of Ghost is now supported! Changes include:

  • Requires MySQL database, available through either of two add-ons:
  • PUBLIC_URL config var renamed to APP_PUBLIC_URL to give it alphabetical precedence
  • The app is configured to use Cloudinary File Storage by default.


step-by-step tutorial

The following video is a step by step tutorial:


Things you should know

After deployment,

  • First, visit Ghost at to set up your admin account
  • The app may take a few minutes to come to life
  • Your blog will be publicly accessible at
  • If you subsequently set up a custom domain for your blog, you’ll need to update your Ghost blog’s APP_PUBLIC_URL environment variable accordingly
  • If you create a lot of content or decide to scale-up the dynos to support more traffic, a more substantial, paid database plan will be required.

🚫🔻 Do not scale-up beyond a single dyno

Ghost does not support multiple processes.

If your Ghost app needs to support substantial traffic, then use a CDN add-on:

How this works

This repository is a Node.js web application that specifies Ghost as a dependency, and makes a deploy button available.

  • Ghost and Casper theme versions are declared in the Node app's package.json
  • Versions are locked and managed using yarn
  • Scales across processor cores in larger dynos via Node cluster API

Updating source code

Optionally after deployment, to push Ghost upgrades or work with source code, clone this repo (or a fork) and connect it with the Heroku app:

git clone
cd ghost-on-heroku

heroku git:remote -a YOURAPPNAME
heroku info

Then you can push commits to the Heroku app, triggering new deployments:

git add .
git commit -m "Important changes"
git push heroku master

Watch the app's server-side behavior to see errors and request traffic:

heroku logs -t

See more about deploying to Heroku with git.

Upgrading Ghost

This repository locks Ghost to the "last tested good version" using the standard yarn.lock file. If you want to upgrade Ghost on your own, you will need to clone or fork this repo as described above. You will then be able to run:

yarn upgrade ghost
git add package.json yarn.lock
git commit -m 'Update dependencies'
git push heroku master

If you're worried about packages beyond the root ghost server being outdated, you can check using yarn outdated.


If you have problems using your instance of Ghost, you should check the official documentation or open an issue on the official issue tracker. If you discover an issue with the deployment process provided by this repository, then open an issue here.


Released under the MIT license, just like the Ghost project itself.