Automate your testing and deployment with CircleCI and GitHub
Join over 300,000 developers already using CircleCI’s first-class integration with GitHub to enable build and test automation.
Why use CircleCI and GitHub?
CircleCI has first-class integration with GitHub that gives you fast, flexible, and efficient continuous integration and delivery.
How does CircleCI integrate with GitHub?
Simply authorize GitHub to work with CircleCI and set up your GitHub repositories to build with CircleCI.
“CircleCI is both the fastest and the easiest CI I’ve used to date.”
Director of Engineering at Opendoor
“CircleCI is the easiest continuous integration tool to get up and running fast. It just works magically.”
Systems Engineer at Branch
“CircleCI gives us an easy platform to run tests, so we can be efficient and move fast.”
Head of Product at Brandfolder
Frequently Asked Questions
What is GitHub?
GitHub is a version control system for software. Version control systems help developers manage changes to their code and prevents conflicts in code bases that are across team members. This allows developers to collaborate on projects, download the latest version of the code, make changes, and upload the newest version.
How does CircleCI work with GitHub?
Once you authorize CircleCI to integrate with GitHub, you can configure the build, test, and deploy processes for your repository within a
config.yml file located in your repository. When you commit code in GitHub, CircleCI is notified via a webhook, and orchestrates the CI/CD jobs specified in your
config.yml file. CircleCI runs your build on our servers (* for cloud hosted) and communicates the status back to GitHub, as well as the CircleCI application.
Why does CircleCI need access to all my repositories?
GitHub only provides very coarse-grained permissions, unfortunately. CircleCI needs concrete permissions to add deploy keys to your repository, add service hooks to your repository, etc. Learn more.
Does CircleCI work with GitHub Enterprise?
Yes. Our server option for CircleCI works with GitHub Enterprise. Contact our team to learn more and try CircleCI with GitHub Enterprise.