Sign up and try CircleCI
To run your very first build on CircleCI, go to the Sign Up page. Sign up with your GitHub, Bitbucket or GitLab account, or your email address for the option to connect to your code later in the process.
Sign up with GitHub or Bitbucket
-
Click on either Sign Up with GitHub or Sign Up with Bitbucket to start the authentication process and allow CircleCI to access your code.
If you are using GitHub, you have the option to limit CircleCI, preventing access to your private repositories. To do this, use the drop down menu at the side of the Sign Up button, and select Public Repos Only from the list. -
Type your GitHub or Bitbucket username, password, and two-factor authorization if applicable, then click Sign In/Login.
-
Click the Authorize Application or equivalent button. You will be redirected to the CircleCI pipelines dashboard.
-
Use the Projects page of the CircleCI app to start building your project code.
Sign up with GitLab
| The full set of documentation for integrating GitLab with CircleCI can be found on the GitLab integration page. |
Sign up with email
-
Click Sign Up with Email.
-
Enter your email address, and then set a secure password for your CircleCI account. A verification email is sent to the email address provided.
-
If you do not want to connect to your code and only wish to continue with the email signup, click Cancel. You will be taken to a screen where you can respond to prompts that best describe your role and your engineering organization.
-
Explore some example projects within the CircleCI app if you do not want to connect to your code at this time. You can take a look at a popular open source project building on CircleCI ( React by Facebook), or one of our own sample projects: a sample JavaScript app, and a sample Python app.
You will be able to start exploring features such as pipelines and workflows. The Dashboard, Projects, Organization Settings, and Plan pages are not available until you connect your code.
When you are ready, you can connect to your GitHub, BitBucket, or GitLab accounts from the CircleCI web app.
Terms
By signing up, you are agreeing to our SaaS Agreement and Privacy Policy. We ask for read/write access to make your experience seamless on CircleCI. If you are a GitHub user and aren’t ready to share access to your private projects, you can choose public repos instead. Protected by reCAPTCHA, Google Privacy Policy and Terms of Service apply.
Next steps
-
Go to the Hello World page to learn the basics of setting up projects, switching orgs, and the
.circleci/config.ymlfile that determines your execution environment and automates your tests. -
Read the Concepts page for an overview of foundational CircleCI concepts such as pipelines, executors and images, workflows, and jobs.
Help make this document better
This guide, as well as the rest of our docs, are open source and available on GitHub. We welcome your contributions.
- Suggest an edit to this page (please read the contributing guide first).
- To report a problem in the documentation, or to submit feedback and comments, please open an issue on GitHub.
- CircleCI is always seeking ways to improve your experience with our platform. If you would like to share feedback, please join our research community.
Need support?
Our support engineers are available to help with service issues, billing, or account related questions, and can help troubleshoot build configurations. Contact our support engineers by opening a ticket.
You can also visit our support site to find support articles, community forums, and training resources.
CircleCI Documentation by CircleCI is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.