Heroku makes it easy to collaborate with others. Collaborating allows you to share access to your source code, make any changes and deploy a new version of the application quickly and easily.

You can start sharing existing applications with a single command.

This articles shows how new collaborators can get started.

Setting Up to Collaborate

Set up your local workstation with the Heroku command-line client and the Git revision control system. The Heroku Toolbelt makes it easy to install both of these dependencies:

Collaborating On an App

Clone the code

Once you’ve been invited to collaborate on an application, the first step is to clone the git repo to your local machine. The invitation email included the name of the app. First ensure that your keys are already on Heroku. If this is the first time you have ever used the CLI, run:

$ heroku login
$ heroku keys:add

To clone the git repo, simply run this command, filling in the appropriate app name:

$ git clone git@heroku.com:APPNAME.git -o production

This will create a directory called APPNAME, with a full copy of the git repository. It also sets up a git remote called production. If you’d prefer to name this something else (e.g. heroku, or staging), simply change the parameter after the -o flag.

Edit and Deploy

You can now make your changes. When you are ready to deploy these changes, simply commit and push your changes:

$ git commit -a -m "log of the changes I made"
$ git push production master
-----> Heroku receiving push
-----> Launching.... done