Registering a DevHub


Dev Hub is the main Salesforce Org that you and your team use to create, delete and manage your Salesforce Scratch Orgs. A Scratch Org is a temporary deployment of Salesforce source code and metadata. Any number of Salesforce Scratch Orgs can be created to start a new project, to start a new feature branch, to test a new feature, start automated testing, perform development tasks directly in an Org, and start from scratch with a fresh new org.


To register a Dev Hub, you must enable Dev Hub, and configure Salesforce Dev Hub set up in your Salesforce Organization.

To enable Dev Hub in an org

  1. Log in as system administrator to your developer edition, production org, or business org.

  2. Navigate to Develop > Dev Hub or enter Dev Hub in the Quick Find box. If you don't see Dev Hub in the Setup menu, make sure your org is one of the supported editions.

  1. To enable Dev Hub, click Enable. Also, enable unlocked packages and second-generation managed packages to develop 2GP packages. Once you enable Dev Hub, you can no longer disable it.

Procedure to register a Dev Hub

  1. Hover your mouse over the SFDX module and select the option: Hub Management


  1. In the Register Dev HUB screen, enter the Dev Hub name.

  2. Select the Environment.

  3. The remaining fields are populated by default. Click Register Dev Hub.

  1. It will redirect to the Salesforce login page where you need to click Allow to allow access to your Salesforce Org.

  2. When your Dev Hub is ready, it will appear on the HUB MANAGEMENT page.

  3. Now, user with owner or admin access to the dev Hub, can limit activity to certain users and restrict all other users from interacting with it. This can be achieved using the HUB LEVEL PERMISSIONS option.

  1. Under the Hub Level Permissions screen, select the users to whom you want to grant permissions to access the dev hub org. Click Save.

  1. In order to view your org’s limits and how close you are to reaching them, you can view such information using View Org's API Limits. Click on the VIEW ORG's API LIMITS button and it will display the remaining and maximum calls and events for your org.

View Packages

To view the managed/unlocked packages for your dev hub, click on the VIEW PACKAGES button.

This lists down all the packages available in your dev hub in the record view. Click on the expand arrow for each package to view the version of the package in chronological order along with package details.

Scroll to the right side of the screen to view the Anchestors for your managed packages only.

Note: Ancestors are visible only for managed packages.

What's Next?

The next topic will be Scratch Orgs, their advantages, and the procedures to create and register them with your dev hub in ARM. To navigate directly to the Scratch Org section, click here.

Last updated