> For the complete documentation index, see [llms.txt](https://docs.akto.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.akto.io/integrations/ci-cd-integrations/github-actions/create-github-app.md).

# Create GitHub App

Add Akto app in your GitHub organization

## **Steps to integrate Github App**

* Create a new Github App from developer settings
* Install created Github App to your repositories
* Integrate the Github App to Akto dashboard

### **Create new Github App**

* Go to `Settings > Developer Settings > Github Apps` on your github dashboard and click `New Github App`

<figure><img src="https://2916937215-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRc4KTKGprZI2sPWKoaLe%2Fuploads%2Fgit-blob-2f34dea881530607ae217e6f2956dc8f97642dd0%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

* While creating new Github App, use name as `Akto Github App` with following permissions
  * Read permissions : **Administration**, **code**, **member**, **metadata**
  * Read and write permissions : **checks**, **issues**, **pull requests**

<figure><img src="https://2916937215-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRc4KTKGprZI2sPWKoaLe%2Fuploads%2Fgit-blob-bb55bc60fcea068e34e08f578fde42baf80c20c1%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

### **Install created Github App**

* After app creation, install github app to your repositories

<figure><img src="https://2916937215-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRc4KTKGprZI2sPWKoaLe%2Fuploads%2Fgit-blob-bea5219fe245bd9e67a793df0fa703a7bc62a681%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

* Once setup is done you will need **Github App Id** and **Private key** as `.pem` file.

<figure><img src="https://2916937215-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRc4KTKGprZI2sPWKoaLe%2Fuploads%2Fgit-blob-97c880f929dc9063dffd314693d526f007a42a00%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

* Download private key as `.pem` file

<figure><img src="https://2916937215-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRc4KTKGprZI2sPWKoaLe%2Fuploads%2Fgit-blob-207d023781c9f4d8c36531a28949943383b74d5e%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

### **Integrate the Github App to Akto dashboard**

* In Akto dashboard go to `Settings > Integrations > Reporting > Github App` and click `Configure`

<figure><img src="https://2916937215-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRc4KTKGprZI2sPWKoaLe%2Fuploads%2Fgit-blob-6d82f013f4b368f83c4cfa1a5fce8bd2913f306f%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

* Add Github App Id and upload secret key `.pem` file.

<figure><img src="https://2916937215-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRc4KTKGprZI2sPWKoaLe%2Fuploads%2Fgit-blob-c179abbdb1c13acf833e8efd779046eed69086b3%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

* Final screen after integrating Github App.

<figure><img src="https://2916937215-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRc4KTKGprZI2sPWKoaLe%2Fuploads%2Fgit-blob-6507ad0ee04f2b2491cd626f3a8ac1da37af6130%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>