Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Heroku Client
Branch: master
Pull request Compare This branch is 1 commit ahead, 3597 commits behind heroku:master.

Loading database.yml through ERB

Many standard database configurations make use of ERB to organize YML
files. An informal twitter poll suggested it's okay to assume folks
have access to ERB. I could put it in a rescue block if you don't
like this though.
latest commit 811792c70f
@JackDanger authored
Failed to load latest commit information.
bin removed gem dependency with taps; lazy loading it
lib Loading database.yml through ERB
spec moved error format from Addons to Heroku::Command'
.gitignore ignore vim .swp files README: added Terence Lee to collaborators
Rakefile Jeweler uses the version specified in Heroku::Client.version
heroku.gemspec v1.4

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 Workflow

Create a new Rails app and deploy it:

rails myapp && cd myapp   # Create an app
git init                  # Init git repository
git add .                 # Add everything
git commit -m Initial     # Commit everything
heroku create             # Create your app on Heroku
git push heroku master    # Deploy your app on Heroku


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. If you're on a Mac, these are saved to your Keychain. Otherwise they are stored in plain text in ~/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.


Created by Adam Wiggins

Maintained by Pedro Belo

Patches contributed by:

  • Chris O'Sullivan
  • Blake Mizerany
  • Ricardo Chimal
  • Les Hill
  • Ryan Tomayko
  • Sarah Mei
  • Nick Quaranto
  • Matt Buck
  • Terence Lee
  • Caio Chassot

Released under the MIT license.

Something went wrong with that request. Please try again.