Sign Up and Try CircleCI
To run your very first build on CircleCI, go to the Sign Up page. Sign up with your GitHub or Bitbucket 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. Note: 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. The CircleCI Pipelines Dashboard appears.
- Use the Projects page of the CircleCI app to start building your project code.
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.
-
Select the options that best describe you and your engineering organization.
-
Connect to your code, or explore some example projects within the CircleCI app if you don’t want to connect to your code at this time.
- Connect to your GitHub or Bitbucket account to build and deploy your projects on CircleCI. Type your GitHub or Bitbucket username, password, and two-factor authorization if applicable, then click Sign In/Login.
- Explore the app using 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’ll 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 GitHub or Bitbucket accounts.
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 Hello World page to learn the basics of setting up projects, switching orgs, and the
.circleci/config.yml
file 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.