# Introduction

SonarQube’s integration with GitHub Enterprise and GitHub.com allows you to maintain code quality and security in your GitHub repositories.

With this integration, you’ll be able to:

* Authenticate with GitHub: Sign in to SonarQube with your GitHub credentials.
* Import your GitHub repositories: Import your GitHub repositories into SonarQube to easily set up SonarQube projects.
* Analyze projects with GitHub Actions: Integrate analysis into your build pipeline. Starting in [Developer Edition](https://www.sonarsource.com/plans-and-pricing/developer/), SonarScanners running in GitHub Actions jobs can automatically detect branches or pull requests being built so you don’t need to specifically pass them as parameters to the scanner.
* Report your quality gate status to your branches and pull requests (starting in [Developer Edition](https://www.sonarsource.com/plans-and-pricing/developer/)): See your quality gate and code metric results right in GitHub so you know if it’s safe to merge your changes.
* Display code scanning alerts for vulnerability issues in GitHub: Display security issues found by SonarQube as code scanning alerts in the GitHub interface.
* Manage your monorepos: Import your monorepo into SonarQube to easily manage the related projects.

{% hint style="info" %}
If you’re using GitHub Enterprise, we recommend using [GitHub Enterprise version 3.4+](https://docs.github.com/en/enterprise-server@3.4).
{% endhint %}

## Related pages <a href="#related-pages" id="related-pages"></a>

* [introduction](https://docs.sonarsource.com/sonarqube-server/10.6/devops-platform-integration/github-integration/setting-up-at-global-level/introduction "mention")\
  This section explains how to set up GitHub and SonarQube for their integration at the global level. You need the global Administer System permission in SonarQube to perform this setup.
* [importing-github-repositories](https://docs.sonarsource.com/sonarqube-server/10.6/devops-platform-integration/github-integration/importing-github-repositories "mention")\
  Once the integration of SonarQube with GitHub has been properly set up, you can import a GitHub repository or monorepo to create the corresponding project(s) in SonarQube.
* [setting-up-at-project-level](https://docs.sonarsource.com/sonarqube-server/10.6/devops-platform-integration/github-integration/setting-up-at-project-level "mention")\*\* \*\* This page explains how to set up GitHub integration features for a given project, such as pull request decoration or the blocking of pull requests in case of quality gate failure. You need the Administer permission on the project to perform this setup.
* [adding-analysis-to-github-actions-workflow](https://docs.sonarsource.com/sonarqube-server/10.6/devops-platform-integration/github-integration/adding-analysis-to-github-actions-workflow "mention")\
  Once you have created your project(s) in SonarQube, you can add the SonarQube analysis to your GitHub Actions workflow, in a standard case and in the case of a monorepo.


---

# 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.sonarsource.com/sonarqube-server/10.6/devops-platform-integration/github-integration/introduction.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.