# 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/G5V5QICNk8zGIRyoKRqA" 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/hkgZ1eTL2w7EOjjsRcQY" alt=""><figcaption></figcaption></figure>

### **Install created Github App**

* After app creation, install github app to your repositories

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

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

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

* Download private key as `.pem` file

<figure><img src="/files/zmfPspBEzNEnnGliH9TF" 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/9VF4cqThPqTxqGGoHqRv" alt=""><figcaption></figcaption></figure>

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

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

* Final screen after integrating Github App.

<figure><img src="/files/9FOrIeHGQI2bcVgvzeYA" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.akto.io/integrations/ci-cd-integrations/github-actions/create-github-app.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.