Start Free
Latest | DevOps platform integration | GitHub integration | Importing GitHub repositories

Importing your GitHub repositories into SonarQube Server

On this page

Once the integration of SonarQube Server with GitHub has been properly set up, you can import a GitHub repository to create the corresponding project in SonarQube Server. The so-created SonarQube Server project is "bound" to its GitHub repository. With a bound project:

  • You can see in the SonarQube Server UI with which repository the project is associated.
  • The quality gate status report to GitHub on pull requests is automatically set up.
  • The report of security alerts to GitHub can be set up.

To import a GitHub repository into SonarQube Server, do one of the following:

  • Import the GitHub repository from the SonarQube Server UI: see below.
    You need access to the GitHub repository and you need the Create Projects permission in SonarQube Server.
  • Analyze a repository from a GitHub action. SonarQube Server will create the corresponding project in SonarQube Server and will automatically bind it to the GitHub repository if it finds a matching GitHub integration configuration in its database. See Adding a SonarQube Server analysis to your GitHub Actions workflow.

Importing GitHub repositories

To import GitHub repositories into SonarQube Server:

  1. In the top navigation bar of SonarQube Server, select the Projects tab.
  2. In the top right corner, select the Create Project > Import from DevOps platforms button.
  3. In the Import from GitHub section, select Setup. The GitHub project onboarding page opens. 
  4. In the GitHub project onboarding page, select the GitHub organization and then the repository(ies) you want to import. 
  5. Select the Import button. The Clean as You Code setting page opens.
  6. Select the new code definition option.
  7. Select the Create projects button.

Importing a GitHub monorepo

See Managing the projects of a monorepo.


Was this page helpful?

© 2008-2024 SonarSource SA. All rights reserved. SONAR, SONARSOURCE, SONARQUBE, and CLEAN AS YOU CODE are trademarks of SonarSource SA.

Creative Commons License