> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/internal-developer-portal/new-to-idp/get-started/step-1-configure-git-integrations-get-started.md).

# Step 1: Configure Git Integrations

{% @harness-package-selector/package-selector platforms="%5B%7B%22label%22%3A%22Step%201%3A%20Configure%20Git%20Integrations%22%2C%22slug%22%3A%22step-1-configure-git-integrations%22%2C%22path%22%3A%22internal-developer-portal%2Fnew-to-idp%2Fget-started%2Fstep-1-configure-git-integrations-get-started%22%7D%2C%7B%22label%22%3A%22Step%202%3A%20Set%20up%20Software%20Catalog%22%2C%22slug%22%3A%22step-2-set-up-software-catalog%22%2C%22path%22%3A%22internal-developer-portal%2Fnew-to-idp%2Fget-started%2Fstep-2-set-up-software-catalog-get-started%22%7D%2C%7B%22label%22%3A%22Step%203%3A%20Create%20Self-Service%20Workflows%22%2C%22slug%22%3A%22step-3-create-self-service-workflows%22%2C%22path%22%3A%22internal-developer-portal%2Fnew-to-idp%2Fget-started%2Fstep-3-create-self-service-workflows-get-started%22%7D%5D" selectedPlatform="step-1-configure-git-integrations" %}

This guide will walk you through the first steps of onboarding to Harness IDP, including enabling the module, configuring Git connectors, populating your catalog, and importing Harness entities.

***

### Before you begin <a href="#before-you-begin" id="before-you-begin"></a>

#### Provision the IDP admin role <a href="#provision-the-idp-admin-role" id="provision-the-idp-admin-role"></a>

* **Harness IDP** must be provisioned for the given account.
* Only users with the **Harness Account Admin** role or assigned **IDP Admin** role can configure IDP. Go to [Assign Roles and Resource Groups](/harness-ai/use-harness-platform/platform-access-control/add-user-groups.md#assign-roles-and-resource-groups) to assign roles.

![](/files/GKhSOy5w8do3I3iICUCG)

***

### Configure Git integrations <a href="#configure-git-integrations" id="configure-git-integrations"></a>

You land on the IDP module by navigating from the sidebar after logging into your Harness account. We strongly recommend users to follow the onboarding guide by selecting **Get Started**, for a seamless onboarding resulting in a catalog with software components.

{% embed url="<https://app.tango.us/app/embed/e910ff06-1277-4812-aed3-0f5c7f70bc8d?skipCover=true&defaultListView=false&skipBranding=false&makeViewOnly=true&hideAuthorAndDetails=true>" %}
Start Internal Developer Portal in Harness
{% endembed %}

Now that you are on the onboarding wizard, let us get started with setting up Git connectors to onboard the software components.

#### Setup Git connectors <a href="#setup-git-connectors" id="setup-git-connectors"></a>

The software components in IDP are defined using YAML files, which are typically stored in your Git repositories. Configuring a connector for these Git providers is essential to fetch and manage these YAML files.

The following Git providers are supported:

* [Harness Code Repository](https://www.harness.io/products/code-repository)
* GitHub ([Cloud](/harness-ai/use-harness-platform/connectors/code-repositories/connect-to-code-repo.md#connect-to-github) & [Enterprise](https://docs.github.com/en/enterprise-server@3.14/admin/overview/about-github-enterprise-server))
* [GitLab](/harness-ai/use-harness-platform/connectors/code-repositories/connect-to-code-repo.md#connect-to-gitlab) (Cloud & Self Hosted)
* [Bitbucket](/harness-ai/use-harness-platform/connectors/code-repositories/connect-to-code-repo.md#connect-to-bitbucket)

> **Note:** Multiple Connectors with different hostnames can be used for a single Git Provider at once. While setting up the connector, both Account & Repo type URLs are supported. Connection through Harness platform and delegate is supported.

{% tabs %}
{% tab title="Interactive Guide" %}
{% embed url="<https://app.tango.us/app/embed/76371411-0ce5-49f6-82f8-7aa90098d559?skipCover=true&defaultListView=false&skipBranding=false&makeViewOnly=true&hideAuthorAndDetails=true>" %}
Configure Git Connectors
{% endembed %}
{% endtab %}

{% tab title="Step-by-Step" %}
**Set up Git connectors**

1. Select **Harness Code Repository** if enabled, or choose your preferred **Git Provider** from the available options.
2. From the dropdown under **Select Connector**, either select an already present connector or create **+New Connector**.
3. Configure the Connector as per the [documentation](/harness-ai/use-harness-platform/connectors/code-repositories/connect-to-code-repo.md).
4. Select **Apply Selected** to use the connector.
5. After the connection test runs, select **Finish** to save the connector.
   {% endtab %}
   {% endtabs %}

***

### Next steps <a href="#next-steps" id="next-steps"></a>

Now that you have completed the initial setup:

* [Create and manage catalog entities](/internal-developer-portal/use-idp/software-catalog/overview.md)
* [Set up workflows for self-service](/internal-developer-portal/use-idp/self-service-workflows/overview.md)