---
layout: page
title: "Using Octopress with Heroku"
date: 2011-09-10 17:58
sidebar: false
footer: false
---

If you don't already have a Heroku account, [create one](https://api.heroku.com/signup), it's free. Then install the Heroku gem.

## Basic Octopress setup

First make sure you've installed the [Heroku Toolbelt](https://toolbelt.heroku.com/). (Note: the heroku gem has been deprecated.)

Next create a heroku app for deployment. If this is your first time using Heroku, this command will ask for your account credentials,
and automatically upload your public SSH key. If you don't already have a public key follow [Github's guide and create one](http://help.github.com/set-up-git-redirect/).

```sh
heroku create
```

This will create a new Heroku app for you to deploy to and add a git remote named 'heroku'.

```sh
# Set heroku to be the default remote for push/fetch
git config branch.master.remote heroku
```

Edit the `.gitignore` in the root of your repository and remove `public`. This will let you add generated content for deploying it to Heroku.

```sh
rake generate
git add .
git commit -m 'site updated'
git push heroku master
```

That's it, you just deployed to Heroku. If you want to set up a custom domain check out the [docs at Heroku](http://devcenter.heroku.com/articles/custom-domains).