Integrating with GitHub

​

Setup

1. Go to your CodSpeed settings
   If you are importing a repository from an organization, you need to be either a Provider Admin or a Admin of this organization. Check out the CodSpeed Roles & Permissions page for more information.
2. Click the “Import” button:
3. Select the organization or the user you want to import the repository from:
4. Select the repositories you want to benchmark and click on “Install”
5. Your repositories should appear in the list of repositories, just click on the “Enable” button to enable the repository:
6. Don’t forget to note the CODSPEED_TOKEN that you’ll need in order to upload performance reports and you’re done 🎉

​

GitHub Permissions

• Repository Permissions
  • Actions (Read/Write): required to access the execution logs of the workflow runs and to annotate/cancel CodSpeed workflows.
  • Checks (Read/Write): required to create check runs for the performance reports.
  • Commit statuses (Read-only): required to access commit status checks.
  • Contents (Read-only): required to access branches and commits.
  • Pull requests (Read/Write): required to access pull requests and annotate them with performance reports comments.
  • Metadata (Read-only): mandatory for all GitHub Apps.
• Organization permissions
  • Members (Read-only): required to access the list of members of the organization.
  • Self-hosted runners (Read/Write): required to register CodSpeed Macro runners at the organization level.
• Account permissions
  • Email addresses (Read-only): required to notify users about installation and configuration changes.