Documentation structure for LLMs (llms.txt)
CircleCI Logo

Sign up and try CircleCI

2 days ago
Cloud

To start building on CircleCI, sign up for an account, then create an organization for your team, or join teammates who are already using CircleCI. CircleCI supports GitHub, Bitbucket, and GitLab projects.

Choose how to sign up:

Your sign-in method determines which kind of organization you get. To learn more, see Understand org types and sign-in methods after you sign up.

Sign up in the web app

From the Sign Up page, do one of the following:

Sign up to build GitHub, GitLab, or Bitbucket Data Center projects

If you want to build mainly GitHub, GitLab, or Bitbucket Data Center projects, sign up with your email address to create an account.

If you want to collaborate on an existing org you can create an account and request an invite later.

  1. Select Sign Up.

  2. Enter your email address and create a password.

  3. Verify your email address.

  4. Set up MFA by following the instructions in the web app.

  5. Choose one of the following:

Sign up to build Bitbucket Cloud projects

If you want to primarily build Bitbucket Cloud projects, sign up with your Bitbucket account. Your org in CircleCI maps directly to your Bitbucket workspace.

  1. Select Sign Up With Bitbucket.

  2. Log in to your Bitbucket Cloud account.

  3. Once you log in and authorize CircleCI, CircleCI takes you to the web app. At this point, you have one bitbucket organization, created with the name of your Bitbucket workspace.

  4. You can now select Projects from the left sidebar and follow your projects. For Bitbucket Cloud, one repository equals one project. When you follow a project, you see its pipelines and runs in the web app.

Sign up with the CLI

The CLI’s onboarding flow is evolving toward a fully terminal-native experience. Currently, starting signup from the CLI opens a browser and hands you off to the same flow described in Sign up in the web app.

The CircleCI CLI has two commands that start signup:

circleci onboard      # scans your repository, generates a config, and signs you up
circleci auth signup  # signup only, no project setup

Both commands open a browser to complete the actual signup, using the same account types and VCS providers described in Sign up in the web app. Add --no-browser to either command to print the sign-in URL instead of opening a browser, for example if you are running the command on a remote or headless machine.

Join an existing org

If your team already uses CircleCI, join their organization instead of creating a new one. Follow the instructions in Join using an invite link or Join without an invite.

If you have an invite email from your team, you are joining an existing CircleCI organization.

  1. Follow the link in your invite email and follow the instructions in the web app.

  2. CircleCI takes you to your organization’s dashboard in the web app. From here, you can follow projects or trigger pipelines in projects to which you have access in your organization, or Create New Projects. You will see a run banner at the top of the web app prompting you to authorize through your VCS provider.

Join without an invite

If you do not have an invite link, you can search for your team instead.

  1. After creating an account, select Find Your Team in the Join Your Teammates card on your homepage. This option is also available at any time from the Join Organization menu.

    Screenshot showing the welcome screen with the find your team menu expanded
    Figure 1. Welcome screen with the find your team menu expanded

  2. Choose one of the following:

    • Search via GitHub: Authorize the GitHub OAuth app for read access to your GitHub organization membership. CircleCI then lists all matching organizations you are eligible to join. Select Join Organizations to complete joining.

    • Search via Bitbucket Cloud: Enter your Bitbucket Cloud credentials to authorize CircleCI. CircleCI adds you to your organization automatically.

    • Join via Invite: If you do not see the organization you want to join listed, ask your organization admin for an invite instead. For the steps admins use to send invites, see the Invite Your Team page.

Create an organization

Once you have a CircleCI account, you can create a new organization for your team. In CircleCI, an organization is a collection of projects and users.

For full steps on creating an organization, and what to do next, see the Create an Organization page.

Understand org types and sign-in methods

Your sign-in method and VCS provider together determine what kind of CircleCI organization you get:

  • If you sign up with email and password and add GitHub, GitLab, or Bitbucket Data Center to your org, you choose the VCS integration from Org  VCS Connections. You can also choose it when creating a project. You authenticate with your VCS provider as part of that setup.

  • If you sign up or sign in with a GitHub social login, CircleCI creates a matching organization for you automatically.

  • If you sign up or sign in with Bitbucket Cloud, CircleCI creates a matching organization for you automatically. Every team member joining your org authenticates with Bitbucket during signup, not later.

You cannot use these sign-in methods interchangeably for the same account. For example, using a social login after you already have an email and password account creates a new, separate account connected to your VCS provider.

For the full picture of organization types and VCS integrations and how they affect project creation, see the Users, Organizations, and Integrations Guide.

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 are not ready to share access to your private projects, you can choose public repositories instead. Protected by reCAPTCHA, Google Privacy Policy and Terms of Service apply.

Next steps

  • Read the Invite Your Team page for steps on adding team members to your CircleCI org.

  • Go to the Hello World page to learn the basics of setting up a CircleCI configuration file.

  • Read the Concepts page for an overview of foundational CircleCI concepts such as pipelines and executors.

  • Refer to the full CircleCI Configuration Reference for creating a .circleci/config.yml file, which determines your execution environment and automates your tests.

  • Explore the CircleCI CLI for a terminal-first way to manage projects, runs, and configuration.