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 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
  • Heroku Enterprise
  • Enterprise Teams
  • Developing Apps Within Enterprise Teams

Developing Apps Within Enterprise Teams

English — 日本語に切り替える

Last updated February 07, 2023

Table of Contents

  • Joining an Enterprise Team
  • Developing apps
  • Adding apps to an Enterprise Team
  • Setting a default team
  • Next steps

This feature is currently available in Heroku Enterprise

 

CLI flag names have been upgraded from --org to --team. --org commands are still compatible during this deprecation period.

Developing and deploying applications within an Enterprise Team is largely the same experience as doing so in your personal account. Git-based deploys, command-line scaling, and add-ons all behave as expected. However, just as with account administration, there are a few additions to the experience you should be aware of when working within an Enterprise Team.

Joining an Enterprise Team

Enterprise Teams centralize the management of users and roles. If you wish to join an Enterprise Team, an admin user must add you directly.

Once you have been added to a team, you can select it in the Heroku Dashboard to view its applications. The Heroku Dashboard displays all teams that you belong to in the sidebar.

Developing apps

As an Enterprise Team member, you have the ability to list and access all applications in the team. You can click an app in the app list to view its basic details, including who can give you more permissions on the app.

You need additional permissions on an app to be able to deploy, scale, work with add-ons, etc. Going to an app’s access page will show you what access you currently have on the app. Team admins and users with manage permission on the app can grant you additional permissions.

In the CLI

To access apps in your team, you can list them by specifying the --team flag:

$ heroku apps --team acme-widgets
=== Apps in team acme-widgets
acme-website

To work with an existing app in the CLI, you must join the app first:

$ heroku join -a acme-website
Joining acme-website... done.

join happens automatically on the Heroku Dashboard.

Leaving an app

When you are no longer working with an application on a regular basis, you can leave the app. This revokes all of your permissions on the app, but you can always click on it again to restore basic view access.

From the CLI, use the leave command:

$ heroku apps:leave --app acme-website
Leaving application acme-website... done

Or, in the Heroku Dashboard, go to the Access tab of the app and remove yourself from the list of members.

Adding apps to an Enterprise Team

If you have existing apps you’ve been developing under your personal account, you need to transfer them to your Enterprise Team in order for them to be considered part of the team and billed against it.

You can use the CLI to transfer apps to your team (where acme-widgets is your team name and deep-spring-4274 is the app):

$ heroku apps:transfer acme-widgets --app deep-spring-4274
Transferring deep-spring-4274 to acme-widgets... done

You can also use the app settings page in the Heroku Dashboard to transfer app ownership.

Apps can also be created directly in the team:

$ heroku create --team acme-widgets
Creating frozen-wave-4030 in organization acme-inc...done
http://frozen-wave-4030.herokuapp.com/ | git@heroku.com:frozen-wave-4030.git
Git remote heroku added

Setting a default team

The Heroku CLI defaults to using your personal account and requires the --team flag when performing team actions. If you generally work under a particular team, you can set the HEROKU_ORGANIZATION environment variable in order to default to that team.

$ export HEROKU_ORGANIZATION=acme-widgets
$ heroku apps
=== Apps joined in organization acme-widgets
frozen-wave-4030
salty-depths-3445

This won’t persist when you open a new shell, however. For that you can add this setting to your profile file. For Unix machines using bash, this is likely ~/.bashrc. For Windows you can set environment variables on the Advanced tab of System in the Control Panel.

Next steps

This guide gives you a high-level overview of developing applications within an Enterprise Team. To learn how to manage a team as an administrator, see one of the articles on creating and managing an Enterprise Team or managing Enterprise Team users and app access.

Keep reading

  • Enterprise Teams

Feedback

Log in to submit feedback.

Using App Permissions in Enterprise Teams Enterprise Teams Permissions and Allowed Actions

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