Table of Contents
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/ | email@example.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
$ heroku apps:rename newname --app oldname http://newname.heroku.com/ | firstname.lastname@example.org: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.