# Git Server

Git server is a centralized platform for hosting Git repositories, facilitating version control and collaboration in software development projects. The IT-Conductor Git Adapter enables seamless integration and synchronization across diverse Git servers, including GitHub, GitLab, BitBucket, Azure DevOps, and self-hosted options. Software development teams use various Git platforms depending on their project requirements and preferences.

### **Configure Git Server in IT-Conductor**

To configure a git server in IT-Conductor, follow the instructions below.

#### **Add New Git Server**

1. Visit [service.itconductor.com](https://service.itconductor.com/) and enter your login credentials.
2. Navigate to **Dashboards → Administrator** to access the **Administrator's Dashboard**.
3. Locate the **Git Servers** actions panel and click the title to access the complete list.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FipvZ8PnQHbUIvf2sNuIY%2Fadmin%20dashboard%20-%20git%20servers.png?alt=media&#x26;token=2935d0df-0c43-44cd-a03b-3633d000d957" alt=""><figcaption><p>Figure 1: Git Servers Actions Panel in Administrator's Dashboard</p></figcaption></figure>

4. Click **Create New Github Connection** <img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FhmTgftJZeJEnJgyNmDBb%2Fimage.png?alt=media&#x26;token=1b94d6c7-f670-4dcc-99ed-1340bfbb4083" alt="" data-size="line"> or **Create New Git Connection** <img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FuCZR9GTjPlWhOkWlf92a%2Fimage.png?alt=media&#x26;token=47cd85c3-ce45-4e4f-8f19-bff41f6136f2" alt="" data-size="line">.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FuownmBvmMlNiUSHoWTU8%2Fgit%20servers%20panel.png?alt=media&#x26;token=fb75141f-5bd0-484f-8a4c-9330939bad3a" alt=""><figcaption><p>Figure 2: Git Servers Actions Panel Page</p></figcaption></figure>

**Add New GitHub Connection**

1. Fill out all the necessary information in the **New Github Instance** wizard. Once completed, click <img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2Fgit-blob-7f816831472c5030e6dfbcb513035d87da645a67%2Fadd.png?alt=media" alt="" data-size="line"> to add the system.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FJVXg4WM0Kp2XVejE5sRx%2Fimage.png?alt=media&#x26;token=597f8266-4882-40fb-8dc1-3d3c2fb32c1d" alt=""><figcaption><p>Figure 3a: New GitHub Instance Wizard (New Git Server Screen)</p></figcaption></figure>

* **Description** - refers to any relevant information about the git server being added.
* **Organization** - refers to an administrative structure that defines objects with a common goal or purpose. If you previously created an organization, please select it.
* **Role** - refers to the environment where the git server will be used.
* **Site** - refers to a logical object that describes a particular area or location, depending on the context in which it is used.
* **Gateway** - allows communication between the customer's site network and the IT-Conductor cloud platform. Select the previously configured gateway from the dropdown menu. See [Gateway Setup](https://docs.itconductor.com/user-guide/setup/gateway-setup) for more details.
* **Host** - refers to the type of git server that will be added to IT-Conductor. By default, it's github.com.

2. Provide the account information in the **New Account** screen and click <img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2Fgit-blob-7f816831472c5030e6dfbcb513035d87da645a67%2Fadd.png?alt=media" alt="" data-size="line"> to complete the configuration.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FBpnHHf5cN7FD4oBg5iLd%2Fnew%20git%20instance%20-%20account.png?alt=media&#x26;token=25a82fd1-b401-4ebc-8494-1c8246e28b2f" alt=""><figcaption><p>Figure 3b: New GitHub Instance Wizard (New Account Screen)</p></figcaption></figure>

* **Description** - refers to any relevant information about the GitHub account being added.
* **Person** - refers to the user who's creating the GitHub instance.
* **User Name** - refers to a unique token generated on GitHub. For more information on generating a token, please refer to this [documentation on managing personal access tokens on Git Hub.](https://docs.github.com/en/enterprise-server@3.9/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens)
* **Token** - allows IT-Conductor to use a GitHub-generated token instead of a username and password.

{% hint style="info" %}
**Note:** When configuring GitHub access, please use the GitHub-generated **Access Token** as the user name (the password field should be blank).
{% endhint %}

4. Verify if the server was added to the **Git Servers** actions panel and check its status.

**Add New Git Connection**

1. Fill out all the necessary information in the **New Git Instance** wizard. Once completed, click <img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2Fgit-blob-7f816831472c5030e6dfbcb513035d87da645a67%2Fadd.png?alt=media" alt="" data-size="line"> to add the system.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2F4Z0SeT6Zyist7trlCdtR%2Fimage.png?alt=media&#x26;token=17edebd6-a1e0-4db0-8d2a-b4c69ba207f0" alt=""><figcaption><p>Figure 4a: New Git Instance Wizard (New Git Server Screen)</p></figcaption></figure>

* **Description** - refers to any relevant information about the git server being added.
* **Organization** - refers to an administrative structure that defines objects with a common goal or purpose. If you previously created an organization, please select it.
* **Role** - refers to the environment where the git server will be used.
* **Site** - refers to a logical object that describes a particular area or location, depending on the context in which it is used.
* **Gateway** - allows communication between the customer's site network and the IT-Conductor cloud platform. Select the previously configured gateway from the dropdown menu. See [Gateway Setup](https://docs.itconductor.com/user-guide/setup/gateway-setup) for more details.
* **Protocol** - refers to the communication protocol (HTTPS by default) that will be used to access the git server.
* **Host** - refers to the type of git server that will be added to IT-Conductor. It can be GitHub, GitLab, BitBucket, or Azure DevOps.

2. Provide the account information in the **New Account** screen and click <img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2Fgit-blob-7f816831472c5030e6dfbcb513035d87da645a67%2Fadd.png?alt=media" alt="" data-size="line"> to complete the configuration.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FtAOzY0RLRLqwpBPiIIlI%2Fnew%20git%20instance%20-%20account2.png?alt=media&#x26;token=30c1c798-5d36-470d-919f-ee389b213d99" alt=""><figcaption><p>Figure 4b: New Git Instance Wizard (New Account Screen)</p></figcaption></figure>

* **Description -** short description of the user.
* **Application** - refers to the type of git server added in step 1.
* **Person** - refers to the user who's creating the Git instance.
* **User name** - unique token generated on GitHub. For more information on generating a token, please refer to this [documentation on managing personal access tokens on Git Hub.](https://docs.github.com/en/enterprise-server@3.9/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens)
* **Token** - this field allows IT-Conductor to use a GitHub-generated token instead of a username and password.

{% hint style="info" %}
**Note:** When configuring GitHub access, please use the GitHub-generated **Access Token** as the user name (the password field should be blank).
{% endhint %}

4. Verify if the newly added connection was added to the **Git Servers** actions panel and check its status.

{% hint style="info" %}
**Note for Git and Github connections:** The status will remain on **Ready** for a few minutes. Refresh the panel if needed. If there are configuration issues, such as incorrect connection parameters or an invalid account, the status will remain on **Ready**. Click on the negative space to trigger the pop-up menu and click on the **Log** icon ![](https://docs.itconductor.com/~gitbook/image?url=https:%2F%2F377464071-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FXhp08OmU8050PePmMgDt%252Fuploads%252FGx0Q4OSu3wOOo5O8ZbQC%252Flog.gif%3Falt=media%26token=55a3b985-c68a-4120-a285-2afac310a988\&width=42\&dpr=4\&quality=100\&sign=c722a48497f25a2090f362f749f70677b04e8ad6a14fbfe2efcbe21458940d70) to display the logs and troubleshoot. If everything is configured correctly, the status will change to **In Progress.**
{% endhint %}

5. Navigate to the service grid and verify if the system was added under the **Git Servers** nod&#x65;**.**

{% hint style="info" %}
**Note:** The server will appear in the service grid within 5-15 minutes.
{% endhint %}

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FipAdqssQUrsF9iUkWPaZ%2F03.png?alt=media&#x26;token=9273400d-7604-4c3e-942e-3d3a4200a0fe" alt=""><figcaption><p>Figure 5: Git Servers in the Service Grid</p></figcaption></figure>


---

# 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://docs.itconductor.com/user-guide/monitoring/infrastructure/git-server.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.
