---
title: "Configure GitHub Connector"
slug: "configure-github-connector"
description: "In this article, we'll cover configuring the GitHub connector."
updated: 2024-10-16T20:55:43Z
published: 2024-10-16T20:55:43Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge.curiositysoftware.ie/llms.txt
> Use this file to discover all available pages before exploring further.

# Configure GitHub Connector

In this article, we'll cover configuring the GitHub connector. Navigate to Workspace -> Connectors, add a new GitHub connector.

The configure connector dialogue has three tabs:

1. Details: Where the connector type and name is set.
2. Connection: The connection and configuration information for the connector.
3. Traceability: Shows which Automation Frameworks in the workspace use this GitHub connector.

![](https://cdn.document360.io/77f722a6-2d0a-49fa-8074-572515a6c4b8/Images/Documentation/image-1729109635401.png)

Select GitHub from the Connector Type dropdown and give this a recognisable Profile Name. Also choose if you would like this connector to be shared among all users in the workspace.

![](https://cdn.document360.io/77f722a6-2d0a-49fa-8074-572515a6c4b8/Images/Documentation/image-1729109769033.png)

In the connection tab, configure the following information:

1. Username: The user you would like to commit code with in GitHub.
2. API Key: Personal access token in GitHub - [https://docs.github.com/en/free-pro-team@latest/github/authenticating-to-github/creating-a-personal-access-token](https://docs.github.com/en/free-pro-team@latest/github/authenticating-to-github/creating-a-personal-access-token) - this personal access token must have read and write access to the target repository.
3. Git Repository: The Git repository URL, you will be able to copy this from GitHub. Ensure that you remove '.git' if you copy the HTTPS.  
![](https://cdn.document360.io/77f722a6-2d0a-49fa-8074-572515a6c4b8/Images/Documentation/image-1729110064631.png)
4. Commit Branch: Defines the branch you want to commit code to in GitHub, this must already exist in GitHub before committing code from Quality Modeller.
5. Pull Request: This is an On or Off toggle.
  1. If **OFF,**code will be pushed directly to the branch specified above.
  2. If **ON,**then a second field will show called Pull Request Target Branch. Here you can specify a branch to create, that will in turn create the pull request to the main commit branch. This is very useful for code reviews before committing to a repository.

There are a number of Advanced optional fields:

![](https://cdn.document360.io/77f722a6-2d0a-49fa-8074-572515a6c4b8/Images/Documentation/image-1729111038772.png)

1. Author (Override): Allows you to override the Author of the code commit. This can be hard coded or you use [UserEmail] to apply the current logged in users email.
2. Name (Override): Allows you to override the Name associated with a code commit. This can be hard coded or you use [UserFullName] to apply the current logged in users name.
3. Git Library: This field lets you choose the underlying library that handles Git operations. This can be set to LibGit2Sharp, a C# wrapper around the native Git library, or Native.
4. HTTP Proxy URL: This field is where you specify the URL of an HTTP proxy server if your network requires it to access external resources over HTTP. For example, [http://proxy.mycompany.com:8080](http://proxy.mycompany.com:8080). In this example, the proxy server’s URL is `proxy.mycompany.com`, and it’s using port `8080`. The proxy would forward your tool’s HTTP requests to GitHub.
5. HTTPS Proxy URL: This field is used to specify the URL of an HTTPS proxy, which handles encrypted HTTPS traffic. For example, [https://secure-proxy.mycompany.com:443](https://secure-proxy.mycompany.com:443). In this example, the proxy server is `secure-proxy.mycompany.com`, and it is listening on port `443` (the standard port for HTTPS traffic)

Finally, there are a number of User Actions that can be applied to the connector.

![](https://cdn.document360.io/77f722a6-2d0a-49fa-8074-572515a6c4b8/Images/Documentation/image-1729111066672.png)

1. Validate: Takes the Saved Username and API Key credentials and tests that a connection can be established and the user can be logged in.
2. ?: Links to this documentation section.
3. Reset: Clears the temporary copy of the Git repository that Quality Modeller stores, this can be useful to run as a troubleshooting step if something goes wrong.
4. Pull: Pulls the latest version of the Git repository into Quality Modeller.
5. Cancel: Cancels any changes made to the configurations.
6. Save: Saves changes.

## Related

- [GitHub](/github.md)
- [Export Automation to GitHub](/export-automation-to-github.md)
- [Clone New Framework to GitHub](/clone-new-framework-to-github.md)
- [Link Existing Framework to GitHub](/link-framework-to-github.md)
- [Git Connector Feature - Proxy Support](/git-connector-feature-proxy-support.md)