1. In the Codefresh UI, follow the steps to[add a new Git provider](#adding-more-git-providers-to-your-codefresh-account).

1. From the list of Git providers, select**Codefresh Github App**.

1. Log in your GitHub account and visit[https://github.com/settings/apps](https://github.com/settings/apps){:target="\_blank"}.

1. Log intoyour GitHub account and visit[https://github.com/settings/apps](https://github.com/settings/apps){:target="\_blank"}.

1. Click**New GitHub App**.

1. Do the following in the New GitHub App screen:

1.Give an arbitrary nameto your app(e.g.codefresh-integration)

1.Fill*Homepage URL* with`http://www.codefresh.io`

1.Uncheck the*Active* checkbox under theWebhook section

1. In the*Repositorypermissions* section give theminimum of

***Contents** - read

***Issues** - read

***Metadata** - read

***Pull requests** - read

***Webhooks** - read, write

***Commit statuses** - read, write

***Email addresses** - read

1. Click the*Create GitHub app* button.

1.Enter an arbitrary namefor your appin**GitHub App name**. For example,`codefresh-integration`.

1.In the**Homepage URL**, enter`http://www.codefresh.io`.

1.In theWebhook section, clear the**Active** checkbox.

1. In the**RepositoryPermissions** section, assign thefollowing permissions:

***Contents**: Read

***Issues**: Read

***Metadata**: Read

***Pull requests**: Read

***Webhooks**: Read, write

***Commit statuses**: Read, write

1. In the**Account Permissions** section, assign the Read permission to**Email addresses**.

1. Click the**Create GitHub app**.

1. In the next screen, do the following:

1. Note down the**App ID** number under the About section.

1. Click**Generate a private key**,and save the file locally.

1.Click the**Install App** item from the left sidebar menu, and then click**Install** next to yourcodefresh app.

1. Click**Generate a private key**, and save the file locally.

1.From thesidebar, click**Install App**, and then click**Install** next to yourCodefresh app.

1. Accept the permissions, and in the next screen, define the repositories that you need Codefresh to access.

From the URL of the browser, note the ending number which is your installation ID.

For example if the URL is`https://github.com/settings/installations/10042353` then your installation number is`10042353`.

1. In the Codefresh UI, go to[Pipeline Integrations > Git](https://g.codefresh.io/account-admin/account-conf/integration/git){:target="\_blank"}.

For example if the URL is`https://github.com/settings/installations/10042353`, then your installation number is`10042353`.

1. In the Codefresh UI, in the toolbar, click the**Settings** icon.

1. From the sidebar, select**Pipeline Integrations > Git**, and then click**Configure**.

1. From the**Add Git Provider** dropdown, select**Github App**.

For the required fields use:

***Installation ID** which you noted down in_step5_.

***App ID**, whichyou noted downin_step4_.

***Private key**, whichis the content of the file your createdinstep 4, converted to base64.

***App ID**, which you noted down in_step4.1_.

***Private key**, whichis the content of the file you createdin_step4.2_, converted to base64.

***Installation ID** whichyou noted downin_step 6_.

1. To verify your integration, click**Test connection**.

1. To apply your changes, click**Save**.