# Registering a DevHub

### Introduction <a href="#introduction" id="introduction"></a>

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](https://knowledgebase.autorabit.com/product-guides/arm/arm-features/salesforce-dx/create-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.

### Prerequisite <a href="#prerequisite" id="prerequisite"></a>

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 <a href="#to-enable-dev-hub-in-an-org" id="to-enable-dev-hub-in-an-org"></a>

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.

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FTOuHa1BRPJaGlIocyvEg%2Fimage.png?alt=media&#x26;token=44268e00-ad49-4b1b-947d-3031c4dc45fb" alt=""><figcaption></figcaption></figure>

3. 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.

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FYCcZvLUMFz5cLCZb51k8%2Fimage.png?alt=media&#x26;token=23521eb9-ecc7-46b2-be57-1272de44ef5c" alt=""><figcaption></figcaption></figure>

### Procedure to register a Dev Hub <a href="#procedure-to-register-a-dev-hub" id="procedure-to-register-a-dev-hub"></a>

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

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2F6xD6KhXQcSHOOlKaMKYF%2Fimage.png?alt=media&#x26;token=071418d4-27cd-4bbb-a16d-2c477bd7ea85" alt="" width="204"><figcaption></figcaption></figure>

2. Click **REGISTER DEV HUB**.

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FNYAYSeHsBQtgI7LwlmIZ%2Fimage.png?alt=media&#x26;token=451b2e34-0e71-4e42-94a7-36a2be7b049a" alt=""><figcaption></figcaption></figure>

3. In the **Register Dev HUB** screen, enter the **Dev Hub** name.
4. Select the **Environment**.
5. The remaining fields are populated by default. Click **Register Dev Hub**.

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2F5dSQ9BYQOIKcZnMlrBa8%2Fimage.png?alt=media&#x26;token=fe65ea76-a211-4a4e-8def-02171a1501f5" alt="" width="375"><figcaption></figcaption></figure>

6. It will redirect to the **Salesforce** login page where you need to click **Allow** to allow access to your Salesforce Org.
7. When your **Dev Hub** is ready, it will appear on the **HUB MANAGEMENT** page.
8. 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.

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FWuyFtooOT55AoC7vMMWW%2Fimage.png?alt=media&#x26;token=38210c42-afb4-4483-8dfc-39fba260e2a0" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FVnyN4lA7VgonhSrnHMg1%2Fimage.png?alt=media&#x26;token=593124cf-f11b-450b-b709-c5affa20e58b" alt="" width="452"><figcaption></figcaption></figure>

10. 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.

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FDJnSYr5EfZ09vUMf1yXJ%2Fimage.png?alt=media&#x26;token=3a346bfa-3d6b-4a01-8fb0-5038f1440d13" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FoX9g8XjDnKx7Kzn2SH6V%2Fimage.png?alt=media&#x26;token=93ff18e1-cc08-4d57-bd00-cad9469d9d22" alt="" width="451"><figcaption></figcaption></figure>

### View Packages <a href="#view-packages" id="view-packages"></a>

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

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FfFQB3yJVPw4zCqwvyVcs%2Fimage.png?alt=media&#x26;token=aef2f68f-cb85-4ba5-baed-ada9385963ea" alt=""><figcaption></figcaption></figure>

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.

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FMdhC7F1aqqKRciY5LEOg%2Fimage.png?alt=media&#x26;token=2b010878-c007-45c3-b415-e5108c6b139d" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FMmr90Upp9HcdeLaPZTC7%2Fimage.png?alt=media&#x26;token=05a40519-4c19-4e29-902c-e70bf726df67" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2F2eLWjdhHHmj7LlZCTsgd%2Fimage.png?alt=media&#x26;token=f3cb8300-ce0d-4c44-a4d2-c151e03af0e1" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Note:** Ancestors are visible only for managed packages.
{% endhint %}

### What's Next? <a href="#whats-next" id="whats-next"></a>

The next topic will be Scratch Orgs, their advantages, and the procedures to create and register them with your dev hub in [ARM](https://www.autorabit.com/). To navigate directly to the Scratch Org section, [click here](https://knowledgebase.autorabit.com/product-guides/arm/arm-features/salesforce-dx/create-a-scratch-org).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://knowledgebase.autorabit.com/product-guides/arm/arm-features/salesforce-dx/registering-a-devhub.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.