> For the complete documentation index, see [llms.txt](https://ai-security-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://ai-security-docs.akto.io/integrations/ci-cd-integrations/github-actions/create-github-app.md).

# Create GitHub App

## **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="/files/v3OkLPooz7BxZJhSgykG" 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="/files/BozO9ep6r8iIE3OYwuE8" alt=""><figcaption></figcaption></figure>

### **Install created Github App**

* After app creation, install github app to your repositories

<figure><img src="/files/RSsKTDatpp3diMHCAKdA" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/UJSlgL6mm5TMdubXV5Yw" alt=""><figcaption></figcaption></figure>

* Download private key as `.pem` file

<figure><img src="/files/ZZoVE5eMbe5IJRTx2Qnu" 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="/files/ijTzNpxFXDxI5rRTxb4n" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/0Rgk9XCzYn3DwPDA0Ohh" alt=""><figcaption></figcaption></figure>

* Final screen after integrating Github App.

<figure><img src="/files/fSfkMEvY3jKGV1W5ghc0" alt=""><figcaption></figcaption></figure>