Skip to main content

GitHub Source Control

Torque supports connecting asset/blueprint repositories on GitHub out of the box. However, to connect a repository, you must have access to the repository and grant Torque permission to the repository's organization, as explained below. For details about connecting a repository, see Discover Your Assets. You should be able to sign in with an account on any one of these online services and immediately get going with connecting asset repositories and launching environments.

In this article:

This article refers to the SAAS version of GitHub (github.com). If you're using self hosted GitHub Enterprise, check here.

Ensure your account is added to the GitHub organization you're connecting​

  1. Go to https://github.com/orgs/{YOUR_ORG}/people.
  2. Make sure your user is listed in the organization. If not, make sure the user is added as a member with global read access.

Ensure your organization has granted access to Torque​

When connecting a repository, Torque installs an OAuth app called Torque Control Plane on the organization. This app provides Torque with the necessary permissions to the organization's repositories. If Torque doesn't have access, you will be prompted to grant the proper authorizations when connecting the asset repository. The approved applications are listed in the GitHub Applications page.

  1. Go to GitHub Applications.

  2. Revoke any existing access to the Quali Torque app.

    Locale Dropdown

  3. In Torque, go to the space's Settings > Repositories area and connect the repository.

  4. Authorize the organization.

    Locale Dropdown

    At this point, the Torque app is installed in the organization without permissions.

  5. Enter your account's password and confirm the action.

    • If you're not an administrator in the organization, ask the administrator to grant access to the app in the GitHub Applications page.
    • If you already authorized the Torque Control Plane app without also granting access to an organization with repositories you want to connect, click the app's name in the GitHub Applications page, and in the Organization access section, click the organization's Request button.

      Locale Dropdown

    The Torque app is granted the necessary permissions and the repository is connected.

  6. Return to Torque and continue setting up the connection.

Token expiration and revocation​

GitHub imposes a limit on the number of tokens an application can create for the same user, and will revoke the oldest one once this limit is passed. For details, see GitHub token expiration and revocation policy.