Renaming Apps from the CLI

Last Updated: 31 January 2013

cli rename

You can rename an app at any time with the heroku apps:rename command. For example, to rename an app named “oldname” to “newname”, change into the app’s git checkout and run:

$ heroku apps:rename newname
http://newname.heroku.com/ | git@heroku.com:newname.git
Git remote heroku updated

Renaming an app will cause it to immediately become available at the new subdomain (newname.heroku.com) and unavailable at the old name (oldname.heroku.com). This may not matter if you’re using a custom domain name, but be aware that any external links will need to be updated.

Renaming without a checkout

You can rename an app while outside a git checkout by passing an explicit --app argument:

$ heroku apps:rename newname --app oldname
http://newname.heroku.com/ | git@heroku.com:newname.git

Note that you will need to manually update any existing git remotes that point to the old name.

Updating Git remotes

If you are using the CLI to rename an app from inside the Git checkout directory, your remote will be updated automatically. If you rename from the website or have other checkouts, such as those belonging to other developers, these will need to be updated manually:

$ git remote rm heroku
$ heroku git:remote -a newname

Replace “newname” with the new name of the app, as specified in the rename command.