Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Ruby Shell
Fetching latest commit...
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


= Heroku API - deploy apps to Heroku from the command line

This library wraps the REST API for managing and deploying Rails apps to the
Heroku platform.  It can be called as a Ruby library, or invoked from the
command line.  Code push and pull is done through Git.

For more about Heroku see

For full documentation see

== Sample Workflows

Create a new Rails app and deploy it:

  rails myapp
  cd myapp
  git init
  git add .
  git commit -m "init"
  heroku create
  git push heroku master

== Setup

  gem install heroku

If you wish to push or pull code, you must also have a working install of Git
("apt-get install git-core" on Ubuntu or "port install git-core" on OS X), and
an ssh public key ("ssh-keygen -t rsa").

The first time you run a command, such as "heroku list," you will be prompted
for your Heroku username and password.  These are saved to ~/heroku/credentials
for future requests.  Your public key (~/.ssh/id_[rd] will be uploaded
to Heroku after you enter your credentials.  Use heroku keys:add if you wish
to upload additional keys or specify a key in a non-standard location.

== Meta

Created by Adam Wiggins

Maintained by Pedro Belo

Patches contributed by: Chris O'Sullivan, Blake Mizerany, Ricardo Chimal, Les Hill, Ryan Tomayko and Sarah Mei

Released under the MIT license:

Something went wrong with that request. Please try again.