Managing Add-ons

Last Updated: 19 May 2015

add-on overview

Table of Contents

You can manage your add-ons either through the command line interface or through the Heroku Dashboard web interface.

Using the command line interface

You can view your current add-ons within an app with the heroku addons command.

$ heroku addons

Creating an add-on:

Previously to add an add-on you could use the command addons:add. That is now deprecated in favor of the create command.
$ heroku addons:create newrelic:wayne
Adding newrelic:wayne on myapp...done, v27 (free)
Use `heroku addons:docs newrelic:wayne` to view documentation

You can also specify the globally unique identifier as well as the key your add-on is attached to when you provision your add-on. You can do this with the --name and --as flags.

Attaching an add-on to another app:

Certain add-ons can be attached to another app. When you attach an add-on it maintains a reference back to the original add-on provision on the initial app.

$ heroku addons:attach shining-sushi-1234 -a sushi
Attaching shining-sushi-1234 to sushi... done
Setting HEROKU_POSTGRESQL_MAROON vars and restarting sushi... done, v81

Destroying an add-on:

Previously to destroy an add-on you could use the command addons:remove. That is now deprecated in favor of the destroy command.
$ heroku addons:destroy shining-sushi-1234
Removing newrelic:wayne from myapp...done, v27 (free)

Upgrade an add-on:

$ heroku addons:upgrade newrelic:hawke
Upgrading newrelic:hawke to myapp... done, v28 ($0.06/dyno/hr)
Use `heroku addons:docs newrelic:hawke` to view documentation

Downgrade an add-on:

$ heroku addons:downgrade newrelic:wayne
Downgrading to newrelic:wayne on myapp... done, v27 (free)
Use `heroku addons:docs newrelic:wayne` to view documentation.

Open an add-on dashboard

$ heroku addons:open newrelic
Opening newrelic:hawke for myapp.

Using the Dashboard

List installed add-ons

To see a list of currently installed add-ons for any application, visit Heroku Dashboard, and click on the name of the app or click on the Resources tab when viewing an app.

Add an add-on

Visit the add-on catalog to find and install add-ons.

Remove, upgrade, or downgrade an add-on

From the app Resources tab, find the add-on section. Click the “Edit” button, make the desired changes, and then click Save to apply your changes.

Edit add-on resources

Configure an add-on

From the app Resources tab, find the add-on resource you want to configure and click on the name. This will take you to a configuration page that allows you to change the settings for the add-on.