Prerequisites

Git installed and on PATH

Installation

Sign up for a Heroku account.  Note the user email address and password.

Download and install the Heroku Toolbelt. (see https://devcenter.heroku.com/articles/quickstart)

Even if you have your own version of Ruby, it’s better to have the Heroku Toolbelt install its own copy (default behavior).  Normally it will be installed in the “ruby-1.9.3” (may be different as new versions are used by the time you read this) subdirectory which is sibling of “bin” and “data”.

Make sure heroku.exe is on the PATH:

C:devprojects>heroku version
heroku/toolbelt/3.10.1 (i386-mingw32) ruby/1.9.3

Run “heroku login” to generate a key-pair under %HOMEPATH%.ssh

Project setup

Create a git project (either via “git clone” or “git init“).

CD to your project root and run “heroku create” to setup Heroku and add the hooks into your project.

Follow instructions on how to set up your app’s auxiliary files, such as adding a “Procfile” file to your project root and adding properties files.

Project deployment

Deployment is normally done simply by running “git push heroku master” to push your code up into Heroku’s Git repo (that was set up by “heroku create” earlier).

One possible error at this point is:

C:devprojectsherokuruby-sample>git push heroku master
Permission denied (publickey).
fatal: Could not read from remote repository.

I found that git looks at %HOME%/.ssh for SSH key files, but normally %HOME% isn’t set.  So modify your environment variables to add this setting:

set HOME=%HOMEPATH%

After the above, “git push” should work.  If not, then there may be a discrepancy between the %%HOME%.sshid_rsa and %HOMEPATH%.sshid_rsa.pub files and what the SSH keys settings are in your Heroku account.