> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Link AppSignal to Repo

The following documentation will walk you through all the steps needed to integrate AppSignal with your GitHub Organization's repositories and link them to your AppSignal apps so that you can set up issue tracking.

## Adding Organization issue tracker integrations

Head over to your application's [integration](https://appsignal.com/redirect-to/app?to=integrations) page. Click on the "Configure" button for GitHub integration.

<img src="https://mintcdn.com/appsignal-715f5a51/nF8c1Rwq1cS7b5hg/assets/images/screenshots/application/integrations/github/link-repo/configure.png?fit=max&auto=format&n=nF8c1Rwq1cS7b5hg&q=85&s=de508dc2b94a07e202ddd4abf4b070f8" alt="GitHub AppSignal integration" width="2560" height="1080" data-path="assets/images/screenshots/application/integrations/github/link-repo/configure.png" />

On the next step click on the "Install GitHub app" button.

<img src="https://mintcdn.com/appsignal-715f5a51/nF8c1Rwq1cS7b5hg/assets/images/screenshots/application/integrations/github/link-repo/install.png?fit=max&auto=format&n=nF8c1Rwq1cS7b5hg&q=85&s=1c39053707bd461b89b4a4c8c1db8a82" alt="Install GitHub app" width="1712" height="550" data-path="assets/images/screenshots/application/integrations/github/link-repo/install.png" />

You will be redirected to GitHub, here you should select your account/organization where the application source code exists.

<img src="https://mintcdn.com/appsignal-715f5a51/nF8c1Rwq1cS7b5hg/assets/images/screenshots/application/integrations/github/link-repo/github-org.png?fit=max&auto=format&n=nF8c1Rwq1cS7b5hg&q=85&s=d9bd8c007caf260e715dbd31c55bbe7a" alt="Select GitHub organization" width="985" height="617" data-path="assets/images/screenshots/application/integrations/github/link-repo/github-org.png" />

You will then be asked to select the repository of your application. Depending on your preference either select "All repositories" or select specific repositories by choosing "Only select repositories". Once done click on "Install & Request" button.

<img src="https://mintcdn.com/appsignal-715f5a51/nF8c1Rwq1cS7b5hg/assets/images/screenshots/application/integrations/github/link-repo/github-repo.png?fit=max&auto=format&n=nF8c1Rwq1cS7b5hg&q=85&s=ba79b467f08bdf8b7e8710f8a8883a33" alt="Select GitHub repository" width="1060" height="810" data-path="assets/images/screenshots/application/integrations/github/link-repo/github-repo.png" />

After this step you will be redirect back to AppSignal where you should link your application in AppSignal with the repository in GitHub using the "linked repository" drop down menu and then click on "Save repository selection" button.

<img src="https://mintcdn.com/appsignal-715f5a51/nF8c1Rwq1cS7b5hg/assets/images/screenshots/application/integrations/github/link-repo/link-repo.png?fit=max&auto=format&n=nF8c1Rwq1cS7b5hg&q=85&s=0ef873f76b652555f95e2d4f901de287" alt="Link GitHub repository" width="1280" height="628" data-path="assets/images/screenshots/application/integrations/github/link-repo/link-repo.png" />

You are now done, if you head back to your application's [integration](https://appsignal.com/redirect-to/app?to=integrations) page you will notice the integration is now active.

<img src="https://mintcdn.com/appsignal-715f5a51/nF8c1Rwq1cS7b5hg/assets/images/screenshots/application/integrations/github/link-repo/linked.png?fit=max&auto=format&n=nF8c1Rwq1cS7b5hg&q=85&s=1fa1ea8f1b5f4d4010c64b64da71d7c8" alt="Complete GitHub integration" width="2560" height="1080" data-path="assets/images/screenshots/application/integrations/github/link-repo/linked.png" />

### Troubleshooting

If you already linked your organization at GitHub with AppSignal and you are not seeing the repository when you visit the [organization integrations page](https://appsignal.com/redirect-to/organization?to=admin/integrations/github). Then click on the "Configure this integration on GitHub" button.

<img src="https://mintcdn.com/appsignal-715f5a51/nF8c1Rwq1cS7b5hg/assets/images/screenshots/application/integrations/github/link-repo/reconfigure.png?fit=max&auto=format&n=nF8c1Rwq1cS7b5hg&q=85&s=e051754adc1633ea5516ace5b24266a6" alt="Re-configure GitHub integration" width="1280" height="381" data-path="assets/images/screenshots/application/integrations/github/link-repo/reconfigure.png" />

You will be redirected to GitHub, make sure you have selected the repository which is missing in AppSignal, or select "All repositories" and click on "Save" button.

<img src="https://mintcdn.com/appsignal-715f5a51/nF8c1Rwq1cS7b5hg/assets/images/screenshots/application/integrations/github/link-repo/select-repositories.png?fit=max&auto=format&n=nF8c1Rwq1cS7b5hg&q=85&s=ab1b4b051d025ca50bbd1ad302b9ad2d" alt="Re-configure GitHub integration" width="960" height="682" data-path="assets/images/screenshots/application/integrations/github/link-repo/select-repositories.png" />

You will be redirected back to AppSignal and you should now be able to see the name of your repository in the "linked repository" drop down.

If anything went wrong while validating the integration your will be prompted with the error message.
Feel free [contact us](mailto:support@appsignal.com) if you experience any problems while setting up this integration.

[github]: https://github.com
