Getting Started as a Collaborator

Last Updated: 05 February 2015

cli collaboration

Table of Contents

Heroku makes it easy to collaborate with others. Collaborating allows you to share apps - permitting collaborators to deploy changes to the application, scale apps and access app data, among other things. Collaborators have the same capabilities as app owners, with a few restrictions.

This article shows new collaborators how to get started.

If you are an app owner, see Collaborating With Other Developers on your App.

Set up

Install the Heroku Toolbelt on your local workstation. This provides access to the Heroku command-line tool and Git.

Clone the app repository

Next, you should clone the app locally. The invitation email includes the name of the app. In this example, the app name is “theirapp”.

$ heroku git:clone -a theirapp

It’s strongly recommended that you get access to the canonical source code repository for the application (for instance on GitHub) and then use heroku git:remote to add a git remote to your checkout. For more information, see Creating a Heroku Remote.

Deploy the app

When you are ready to deploy these changes, commit and then push your changes.

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

To avoid getting out of sync with other collaborators, if you’re not using GitHub Integration, be sure to push your changes to the canonical repository (typically with git push origin master) as well as to the Heroku remote.

Open the app

You can open the app in your browser using the CLI.

$ heroku open

Get information about the app

When someone grants you access to an app, you will receive an email with the app name and some other information to help you get started. You can get more information about the app by using the heroku info command.

$ heroku info --app theirapp

Next steps

Read How Heroku Works for a technical overview of the concepts you’ll encounter while writing, configuring, deploying and running applications.