Skip Navigation
Show nav
Heroku Dev Center
  • Get Started
  • Documentation
  • Changelog
  • Search
  • Get Started
    • Node.js
    • Ruby on Rails
    • Ruby
    • Python
    • Java
    • PHP
    • Go
    • Scala
    • Clojure
  • Documentation
  • Changelog
  • More
    Additional Resources
    • Home
    • Elements
    • Products
    • Pricing
    • Careers
    • Help
    • Status
    • Events
    • Podcasts
    • Compliance Center
    Heroku Blog

    Heroku Blog

    Find out what's new with Heroku on our blog.

    Visit Blog
  • Log inorSign up
View categories

Categories

  • Heroku Architecture
    • Dynos (app containers)
    • Stacks (operating system images)
    • Networking & DNS
    • Platform Policies
    • Platform Principles
  • Command Line
  • Deployment
    • Deploying with Git
    • Deploying with Docker
    • Deployment Integrations
  • Continuous Delivery
    • Continuous Integration
  • Language Support
    • Node.js
    • Ruby
      • Working with Bundler
      • Rails Support
    • Python
      • Background Jobs in Python
      • Working with Django
    • Java
      • Working with Maven
      • Java Database Operations
      • Working with the Play Framework
      • Working with Spring Boot
      • Java Advanced Topics
    • PHP
    • Go
      • Go Dependency Management
    • Scala
    • Clojure
  • Databases & Data Management
    • Heroku Postgres
      • Postgres Basics
      • Postgres Getting Started
      • Postgres Performance
      • Postgres Data Transfer & Preservation
      • Postgres Availability
      • Postgres Special Topics
    • Heroku Data For Redis
    • Apache Kafka on Heroku
    • Other Data Stores
  • Monitoring & Metrics
    • Logging
  • App Performance
  • Add-ons
    • All Add-ons
  • Collaboration
  • Security
    • App Security
    • Identities & Authentication
    • Compliance
  • Heroku Enterprise
    • Private Spaces
      • Infrastructure Networking
    • Enterprise Accounts
    • Enterprise Teams
    • Heroku Connect (Salesforce sync)
      • Heroku Connect Administration
      • Heroku Connect Reference
      • Heroku Connect Troubleshooting
    • Single Sign-on (SSO)
  • Patterns & Best Practices
  • Extending Heroku
    • Platform API
    • App Webhooks
    • Heroku Labs
    • Building Add-ons
      • Add-on Development Tasks
      • Add-on APIs
      • Add-on Guidelines & Requirements
    • Building CLI Plugins
    • Developing Buildpacks
    • Dev Center
  • Accounts & Billing
  • Troubleshooting & Support
  • Integrating with Salesforce
  • Add-ons
  • Managing Add-ons

Managing Add-ons

English — 日本語に切り替える

Last updated November 07, 2022

Table of Contents

  • Using the command line interface
  • Using the dashboard

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
newrelic:wayne
heroku-postgresql:mini

Creating an add-on

Previously to add an add-on you could use the command addons:add. That command 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 specify the globally unique name using the --name flag. You can also specify the key your add-on is attached to using the --as flag.

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 provisioned on the initial app. The add-on must already exist on another app. In this case, the add-on’s fully qualified name is postgresql-rectangular-1234 and we are attaching it to an app named sushi:

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

Detaching an add-on from another app

Add-ons can also be detached if they were previously attached to an app.

$ heroku addons:detach HEROKU_POSTGRES_MAROON -a sushi
Detaching HEROKU_POSTGRES_MAROON to sushi... done
Unsetting HEROKU_POSTGRES_MAROON config vars and restarting sushi... done, v82

Destroying an add-on

Previously to destroy an add-on you could use the command addons:remove. That command is now deprecated in favor of the destroy command.

$ heroku addons:destroy postgresql-rectangular-1234
Removing postgresql-rectangular-1234 from myapp...done, v27 ($5/month)

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 add-ons

To see the add-ons provisioned and attached to an application, visit Heroku Dashboard and click on the name of the app or click 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

Open the Heroku Dashboard. On the app’s Resources tab, scroll down to the Add-ons section. On the rightmost side of the add-on listing, click the actions button (three vertically-stacked dots) to open the menu. From this menu, you can remove, upgrade, or downgrade the add-on.

Edit add-on resources

Additional add-on actions may be possible in this menu as well, such as the back-up functionality provided by Heroku Postgres:

Add-on actions in menu

Attaching an add-on to another app

If an add-on has implemented support for sharing across apps, you can attach that add-on to another app. This can be done in its attachments menu:

Attachment actions in menu

This can also be done through the command line interface by using the heroku addons:attach command.

Configure an add-on

Open the Heroku Dashboard. From the app’s 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.

Keep reading

  • Add-ons

Feedback

Log in to submit feedback.

Sending Email from Your App Sending Email from Your App

Information & Support

  • Getting Started
  • Documentation
  • Changelog
  • Compliance Center
  • Training & Education
  • Blog
  • Podcasts
  • Support Channels
  • Status

Language Reference

  • Node.js
  • Ruby
  • Java
  • PHP
  • Python
  • Go
  • Scala
  • Clojure

Other Resources

  • Careers
  • Elements
  • Products
  • Pricing

Subscribe to our monthly newsletter

Your email address:

  • RSS
    • Dev Center Articles
    • Dev Center Changelog
    • Heroku Blog
    • Heroku News Blog
    • Heroku Engineering Blog
  • Heroku Podcasts
  • Twitter
    • Dev Center Articles
    • Dev Center Changelog
    • Heroku
    • Heroku Status
  • Facebook
  • Instagram
  • Github
  • LinkedIn
  • YouTube
Heroku is acompany

 © Salesforce.com

  • heroku.com
  • Terms of Service
  • Privacy
  • Cookies
  • Cookie Preferences