---
title: "Configuring the GitHub to Pipelines client connection"
date: "2024-02-14T06:18:38+00:00"
summary: "Learn how to configure and manage the connection between your GitHub repository and Acquia Pipelines client. Step-by-step instructions for connecting, disconnecting, and understanding webhooks and deploy keys."
image:
type: "page"
url: "/acquia-cloud-platform/configuring-github-pipelines-client-connection"
id: "2600ea28-beb0-4472-b5a2-e91917129958"
---

Use the procedures on this page to control the connection between your GitHub repository and the optional Pipelines command-line client. If you prefer to use your web browser to connect Cloud Platform to GitHub, see [Connecting an application to an external Git repo](/acquia-cloud-platform/features/pipelines/connect).

Requirements
------------

To configure the Pipelines client integration with GitHub (both to connect and disconnect), you must have the following items:

*   [GitHub permissions](/acquia-cloud-platform/features/pipelines/cli/github/reqs#pipelines-cli-github-perms) for the GitHub repository
*   A [GitHub personal access token](/acquia-cloud-platform/features/pipelines/cli/github/reqs#token)

For information about obtaining these items from GitHub, see [Obtaining required GitHub information](/acquia-cloud-platform/features/pipelines/cli/github/reqs).

Connecting to GitHub
--------------------

To configure the Pipelines client to use a GitHub repository as the source, run the `pipelines github-connect` command as a user with the necessary [GitHub permission](/acquia-cloud-platform/features/pipelines/cli/github/reqs#pipelines-cli-github-perms) for the GitHub repository.

To connect the Pipelines client to GitHub:

*   If you have codebase:
    
        pipelines github-connect --codebase-id = [Acquia codebase ID] [GitHub user/GitHub repo-name] [GitHub token]
    
*   If you have application:
    
        pipelines github-connect --application-id=[Acquia app ID] [GitHub user/GitHub repo-name] [GitHub token]
    

Here,

*   `[Acquia codebase ID]` is the ID of your codebase.
*   `[Acquia app ID]` is your Cloud Platform [application ID](https://docs.acquia.com/acquia-cloud-platform/features/pipelines/cli/commands#appids).
*   `[GitHub user/GitHub repo-name]` is your GitHub user name and the name of the GitHub repository that will be the source repository for build jobs. You can find this in GitHub by selecting the repository and looking in the URL bar or on the repository’s main page.
*   `[GitHub token]` is a [GitHub personal access token](/acquia-cloud-platform/features/pipelines/cli/github/reqs#token) that you generate.

After you have run `pipelines github-connect`, the GitHub repository that you specify in `pipelines github-connect` becomes the default source repository for Pipelines build jobs.

Each time that you use GitHub to create or reopen a pull request, push a commit, or push a tag, Cloud Platform runs the `pipelines start` command using the build definition file in the GitHub repository, and commits the build artifact to your Cloud Platform repository.

GitHub webhooks and deploy keys
-------------------------------

When you run `pipelines github-connect`, the Pipelines client adds a webhook to your GitHub repository.

To view the webhook in GitHub:

1.  Go to your repository, and click **Settings**.
2.  In the menu on the left side, click **Webhooks**.

The Pipelines client also creates a deploy key in your GitHub repository, which gives the client permission to interact with your repository.

To see the deploy key in GitHub:

1.  Go to your repository, and click **Settings**.
2.  In the menu on the left side, click **Deploy keys**.

Disconnecting from GitHub
-------------------------

To disconnect the Pipelines client from a GitHub repository, run the following command:

*   If you have codebase:
    
        pipelines github-disconnect --codebase-id = [Acquia codebase ID] [GitHub user/GitHub repo-name] [GitHub token]
    
*   If you have application:
    
        pipelines github-disconnect --application-id=[Acquia app ID] [GitHub user/GitHub repo-name] [GitHub token]
    

Here,

*   `[Acquia codebase ID]` is the ID of your codebase.
*   `[Acquia app ID]` is your Cloud Platform [application ID](https://docs.acquia.com/acquia-cloud-platform/features/pipelines/cli/commands#appids).
*   `[GitHub user/GitHub repo-name]` is your GitHub user name and the name of the GitHub repository that is the source repository for build jobs. You can find this in GitHub by selecting the repository and looking in the URL bar or on the repository’s main page.
*   `[GitHub token]` is a [GitHub personal access token](/acquia-cloud-platform/features/pipelines/cli/github/reqs#token) that you generate.

Disconnecting your GitHub repository from the Pipelines client also removes the webhook and deploy key added by the connection of the two services.