Deploying on Heroku
To get your own Ghost blog running on Heroku, click the button below:
Fill out the form, and you should be cooking with gas in a few seconds.
Things you should know
After deployment, visit the admin area at
YOURAPPNAME.herokuapp.com/ghostto set up your blog.
Your blog will be publicly accessible at
To make changes to your Ghost blog (like adding a theme to the
/contentdirectory, for instance), clone your blog locally using the Heroku Toolbelt:
heroku git:clone --app YOURAPPNAME
What do I put in the fields?
App name. Pick a name for your application. Heroku says this field is optional, but it’s easier if you choose a name here, because you need to specify the URL of your blog in the first config field anyway. You can add a custom domain later if you want, but this is the name of the application you’ll see in your Heroku dashboard.
Heroku URL. Take the name of your Heroku application, and put it into URL form. For example, if you choose
my-ghost-blogas the app name, the Heroku URL config value needs to be
http://my-ghost-blog.herokuapp.com(no trailing slash). If you subsequently set up a custom domain for your blog, you’ll need to update your Ghost blog’s
HEROKU_URLenvironment variable accordingly.
S3 configuration. All the config fields begining with
S3_…are completely optional, and leaving them blank is totally fine. See the section below on file uploads for details.
Heroku app filesystems aren’t meant for permanent storage, so when it comes to file uploads for a Ghost blog deployed to Heroku, you have two options:
Configure S3 file storage. Create an S3 bucket on Amazon AWS, and then specify your
S3_BUCKET_NAMEas environment variables on Heroku’s deployment page. Once your app is up and running, you’ll be able to upload images via the Ghost UI and they’ll be stored in Amazon S3. :sparkles:
Disable file uploads. Leave all the S3-related environment variable fields blank on Heroku’s deployment page and file uploads will be disabled. Ghost will ask you for external URLs instead of allowing images to be uploaded. If you don’t know what S3 is, this is the option you want.
ProTip™: You can start off with file uploads disabled, and specify all your S3 environment variables at a later stage. You aren’t stuck with the decision you make on the original deploy. :grin:
How this works
This repository is essentially a minimal web application that specifies Ghost as a dependency, and makes a deploy button available.
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.