Heroku

How It Works

Creating Apps from the CLI

Last Updated: 27 January 2011

cli create

The app is the fundamental unit of organization on Heroku. Users can create an unlimited number of apps; each is allocated a new database and a single dyno upon creation.

Creating a Named App

After creating an app, you will probably want to git push to deploy and add collaborators so that others can deploy changes as well.

To create a new app named “myapp”, install the heroku CLI and run the following command:

$ heroku create myapp
Created http://myapp.heroku.com/ | git@heroku.com:myapp.git
Git remote heroku added

The command’s output shows that the app will be available at http://myapp.heroku.com. The second URL, git@heroku.com:high-sunrise-58.git, is the remote git repository URL; by default, the heroku create command automatically adds a git remote named “heroku” pointing at this URL.

Creating an App Without a Name

The app name argument (“myapp”) is optional. If no app name is specified, a random name will be generated.

$ heroku create
Created http://mystic-wind-83.heroku.com/ | git@heroku.com:mystic-wind-83.git

Since Heroku app names are in a global namespace, you can expect that common names, like “blog” or “wiki”, will already be taken. It’s often easier to start with a default name and rename the app later.