Transferring Apps
Last updated January 27, 2022
Table of Contents
You can transfer applications between Heroku accounts or to a Team of which you are a member at any time via the Heroku Dashboard or the Heroku CLI command apps:transfer
. Billing responsibility will transfer to the new owner as of the time of accepting the transfer and the original owner will be responsible for pro-rated usage up until that point. After the transfer is complete, the original owner will be a collaborator on the app.
If you are looking to transfer all apps within a pipeline and want to keep the pipeline intact you should use the pipeline ownership transfer. This will transfer the pipelines ownership including all apps within it. Transferring individual apps within a pipeline will remove them from the pipeline and it will need to be re-created by the new owner.
Initiate transfer
Only the application owner can initiate a transfer request.
Apps can be transferred to a collaborator on the app. If the user is not a collaborator, first add them as a collaborator. If you can’t see the Team that you want to transfer the app to, then you must ask the Team admin to add you to the Team.
To initiate the transfer of the application using the CLI, use apps:transfer
. For example:
$ heroku apps:transfer -a <app-to-transfer> <collaborator-to-transfer-it-to@example.com>
If you need to transfer multiple apps, use the --bulk
flag:
$ heroku apps:transfer --bulk <collaborator-to-transfer-it-to@example.com>
? Select applications you would like to transfer (Press <space> to select, <a> to toggle all, <i> to inverse selection)
❯◯ myapp (heroku)
◯ myotherapp (heroku)
To initiate the transfer of the application using the Dashboard:
- In Dashboard, click the
Settings
tab of the application. - Scroll down to the
Transfer Ownership
section. - Click the
Choose app owner
field. The list of people who are collaborators on the app and the list of Teams and Organizations to which you belong will be displayed. - If you don’t see the person you want to transfer the app to, then you must first add them as a collaborator.
- If you can’t see the Team that you want to transfer the app to, then you must ask the Team admin to add you to the Team.
- Select an item from the list.
- Click
Transfer app
.
To initiate a transfer of one or more applications from a Team to another Team using the Dashboard:
- In Dashboard, click the Team name of the Team you would like to transfer apps into
- Click the
Transfer apps
button - Use the select box to select apps from your personal apps list, or another Team’s apps list
- Select the apps you would like to transfer to the Team
- Click
Transfer apps
.
Accept transfer
A pending transfer request appears near the top of the dashboard of the application being transferred.
You can accept or decline any transfer request you receive. If the app has an ongoing cost, such as paid add-ons or dynos, you begin to accrue its usage/cost after accepting the transfer. If your credit card is not already on file, you are prompted to add it before you can complete accepting the transfer.
Note that you will also be asked to enter your credit card information if verification is required.
Cancel transfer
The owner can cancel the transfer request at any time before the new owner accepts or declines the request.
Downtime
The application will continue to run during a transfer - no downtime is initiated. When transferring a personal application to an Enterprise Team, the dyno type of the application may need to be adjusted, which will require a standard application restart.