Skip to content
circleci Docs
Cancel
  • Getting Started
    • Overview
      • Welcome
      • Sign Up and Try
      • About CircleCI
      • Concepts
      • FAQ
    • Onboarding
      • YAML Configuration Intro
      • Web App Introduction
      • In-app Configuration Editor
    • Beginner Tutorials
      • Configuration Tutorial
      • Your First Green Build
      • Hello World
      • Set up the Slack Orb
    • VCS Integration
      • GitHub
      • Bitbucket
    • Migration
      • Migration Introduction
      • Migrating from AWS
      • Migrating from Azure
      • Migrating from Buildkite
      • Migrating from GitHub
      • Migrating from GitLab
      • Migrating from Jenkins
      • Migrating from TeamCity
      • Migrating from Travis CI
  • Pipelines
    • Overview
      • Pipelines overview
      • Pipeline processing
      • Skip or cancel pipelines
    • Features
      • Scheduled Pipelines
      • Workflows
      • Jobs and Steps
      • Workspaces
      • Artifacts
      • Docker layer caching
      • Concurrency
      • Environment variables
      • Collecting test data
      • Code Coverage
      • Debugging with SSH
      • Test Splitting and Parallelism
      • Troubleshooting Test Splitting
      • Contexts
      • OpenID Connect Tokens
      • Using Webhooks with 3rd party tools
    • Optimizations
      • Overview
      • Persisting Data
      • Caching dependencies
      • Caching strategies
      • Pipeline values and parameters
      • Using shell scripts
    • Tutorials
      • Test splitting
  • Execution environments
    • Overview
      • Introduction
      • Migrating Docker to Machine
    • Docker
      • Using Docker
      • Convenience Images
      • Migrating to Next-Gen Images
      • Using custom images
      • Docker authenticated pulls
      • Running docker commands
    • Linux VM
      • Using Linux VM
      • Android Machine Image
    • macOS
      • Using macOS
      • Configuring a macOS app
      • Testing iOS applications
      • Testing macOS applications
      • iOS Code Signing
      • Xcode Image Policy
      • Dedicated Host Resources
    • Windows
      • Using Windows
      • Hello World
    • GPU
      • Using GPUs
    • Arm
      • Using Arm
    • Runner
      • Self-hosted Runner Overview
      • Self-hosted Runner Concepts
      • Web App Installation
      • CLI Installation
      • Linux Installation
      • Windows Installation
      • macOS Installation
      • Docker Installation
      • Kubernetes Installation
      • Self-hosted Runner Supported Platforms
      • Scaling Self-hosted Runner
      • Self-hosted Runner Configuration Reference
      • Upgrading Self-hosted Runner on Server
      • Self-hosted Runner API
      • Self-hosted Runner FAQ
  • Configuration
    • Overview
      • Configuration Introduction
      • Dynamic Configuration
      • Using the CircleCI Configuration Editor
      • Writing Yaml
    • Reference
      • Configuration Reference
      • Reusing Configuration
      • Advanced Configuration
      • Sample Configuration
      • Installing the CircleCI CLI
      • How to use the CircleCI CLI
    • How-To Guides
      • Using Matrix Jobs
      • Using Branch Filters
      • Using Dynamic Configuration
      • Selecting a Workflow to Run
      • Installing and using docker-compose
  • Orbs
    • Using Orbs
      • Orb Introduction
      • Orbs Concepts
      • Orbs FAQ
    • Authoring Orbs
      • Intro to Authoring an Orb
      • Author an Orb
      • Orb Author FAQ
      • Orb Authoring Best Practices
      • Orb Testing Methodologies
      • Orb Publishing Process
      • Manual Orb Authoring
    • Tutorials
      • Using the Slack Orb
    • How-To Guides
      • Deploy Service Update to EC2
      • Notify a Slack Channel of a Paused Workflow
  • Insights
    • Overview
    • Metrics glossary
    • Insights snapshot badge
    • Test Insights
    • Data Partnerships
    • Insights API
  • Projects
    • overview
      • Projects Overview
      • Creating a Project
    • settings
      • Settings Overview
      • Enabling GitHub Checks
      • Adding SSH Keys
      • Open Source Projects
      • Using Notifications
      • Connect with JIRA
      • Managing API tokens
      • Status Badges
      • Webhooks
      • Using Credits
    • security
      • Security Features
      • Security Recommendations
      • Protecting Against Supply Chain Attacks
      • IP Ranges
  • Examples and Guides
    • Languages
      • Overview
      • Node
      • Python
    • Databases
      • Configuring Databases
      • Database Examples
    • Testing
      • Overview
      • Browser Testing
  • Deployment
    • Configuring Deploys
    • Deployment Examples
    • Deploying iOS applications
    • Upload to Artifactory
    • Publishing to Packagecloud
    • Google Cloud SDK
  • Reference
      • Configuration Reference
      • API v2 Reference
      • API v2 Introduction
      • API v2 Developer's Guide
      • API v1.1 Reference
      • Project Values and Variables
      • Prebuilt Images
      • Glossary
      • Help and Support
  • Server Administration v3.x
    • Server v3.x Overview
      • Overview
      • What's New in v3.x
      • Upgrade
      • FAQ
    • Server v3.x Install
      • Phase 1 - Prerequisites
      • Phase 2 - Install Core Services
      • Phase 3 - Install Execution Environment
      • Phase 4 - Post Installation
      • Migration
      • Hardening Your Cluster
    • Server v3.x Operations
      • Overview
      • Metrics and Monitoring
      • Introduction to Nomad
      • Configuring a Proxy
      • User Accounts
      • Managing Orbs
      • VM Service
      • Externalizing Services
      • Expanding Internal Database Volumes
      • Load Balancers
      • Authentication
      • Docker Authenticated Pulls
      • Build Artifacts
      • Usage Data
      • Security
      • Application Lifecycle
      • Troubleshooting and Support
      • Backup and Restore
    • Server v3.4.x PDFs
      • v3.4 Overview
      • v3.4 Installation Guide for AWS
      • v3.4 Installation Guide for GCP
      • v3.4 Operations Guide
    • Server v3.3.x PDFs
      • v3.3 Overview
      • v3.3 Installation Guide for AWS
      • v3.3 Installation Guide for GCP
      • v3.3 Operations Guide
    • Server v3.2.x PDFs
      • v3.2 Overview
      • v3.2 Installation Guide
      • v3.2 Operations Guide
    • Server v3.1.x PDFs
      • v3.1 Overview
      • v3.1 Installation Guide
      • v3.1 Operations Guide
    • Server v3.0.x PDFs
      • v3.0 Overview
      • v3.0 Installation Guide
      • v3.0 Operations Guide
  • Server Administration v2.x
    • Server v2.19.x Install
      • Overview
      • What's New in v2.19.x
      • Upgrade to v2.19.x
      • Updating Replicated
      • System Requirements
      • Prerequisites and Planning
      • Installation
      • Teardown
    • Server v2.19.x Operations
      • Overview
      • Intro to Nomad
      • Metrics & Monitoring
      • Nomad Metrics
      • Proxies
      • Docker Hub Pull Through Mirror
      • Authentication
      • VM Service
      • GPU Builders
      • Certificates
      • User Accounts
      • Build Artifacts
      • Usage statistics
      • JVM Heap Size
      • SSH Reruns
      • Maintenance
      • Backup and Recovery
      • Security
      • Troubleshooting
      • Faq
      • Customization & Config
      • Architecture
      • Storage Lifecycle
      • Acknowledgments
    • Server v2.19 PDFs
      • What's New in v2.19
      • v2.19 Installation Guide
      • v2.19 Operations Guide
    • Server v2.18 PDFs
      • What's New in v2.18
      • v2.18.3 Installation Guide
      • v2.18.3 Operations Guide
    • Server v2.17.3 PDFs
      • What's New in v2.17
      • v2.17.3 Installation Guide
      • v2.17.3 Operations Guide
    • Server v2.16 PDFs
      • What's New in v2.16
      • v2.16 Installation Guide
      • v2.16 Operations Guide
  • CircleCI Plans
    • Plan Overview
    • Free
    • Performance
    • Scale
    • Server
Select Language
English 日本語
Request a language
circleci.com
Start Building for Free Go to Application
  • Documentation Docs (0)
  • Orbs (0)
  • Convenience Images Images (0)
  • Getting Started
    • Overview
      • Welcome
      • Sign Up and Try
      • About CircleCI
      • Concepts
      • FAQ
    • Onboarding
      • YAML Configuration Intro
      • Web App Introduction
      • In-app Configuration Editor
    • Beginner Tutorials
      • Configuration Tutorial
      • Your First Green Build
      • Hello World
      • Set up the Slack Orb
    • VCS Integration
      • GitHub
      • Bitbucket
    • Migration
      • Migration Introduction
      • Migrating from AWS
      • Migrating from Azure
      • Migrating from Buildkite
      • Migrating from GitHub
      • Migrating from GitLab
      • Migrating from Jenkins
      • Migrating from TeamCity
      • Migrating from Travis CI
  • Pipelines
    • Overview
      • Pipelines overview
      • Pipeline processing
      • Skip or cancel pipelines
    • Features
      • Scheduled Pipelines
      • Workflows
      • Jobs and Steps
      • Workspaces
      • Artifacts
      • Docker layer caching
      • Concurrency
      • Environment variables
      • Collecting test data
      • Code Coverage
      • Debugging with SSH
      • Test Splitting and Parallelism
      • Troubleshooting Test Splitting
      • Contexts
      • OpenID Connect Tokens
      • Using Webhooks with 3rd party tools
    • Optimizations
      • Overview
      • Persisting Data
      • Caching dependencies
      • Caching strategies
      • Pipeline values and parameters
      • Using shell scripts
    • Tutorials
      • Test splitting
  • Execution environments
    • Overview
      • Introduction
      • Migrating Docker to Machine
    • Docker
      • Using Docker
      • Convenience Images
      • Migrating to Next-Gen Images
      • Using custom images
      • Docker authenticated pulls
      • Running docker commands
    • Linux VM
      • Using Linux VM
      • Android Machine Image
    • macOS
      • Using macOS
      • Configuring a macOS app
      • Testing iOS applications
      • Testing macOS applications
      • iOS Code Signing
      • Xcode Image Policy
      • Dedicated Host Resources
    • Windows
      • Using Windows
      • Hello World
    • GPU
      • Using GPUs
    • Arm
      • Using Arm
    • Runner
      • Self-hosted Runner Overview
      • Self-hosted Runner Concepts
      • Web App Installation
      • CLI Installation
      • Linux Installation
      • Windows Installation
      • macOS Installation
      • Docker Installation
      • Kubernetes Installation
      • Self-hosted Runner Supported Platforms
      • Scaling Self-hosted Runner
      • Self-hosted Runner Configuration Reference
      • Upgrading Self-hosted Runner on Server
      • Self-hosted Runner API
      • Self-hosted Runner FAQ
  • Configuration
    • Overview
      • Configuration Introduction
      • Dynamic Configuration
      • Using the CircleCI Configuration Editor
      • Writing Yaml
    • Reference
      • Configuration Reference
      • Reusing Configuration
      • Advanced Configuration
      • Sample Configuration
      • Installing the CircleCI CLI
      • How to use the CircleCI CLI
    • How-To Guides
      • Using Matrix Jobs
      • Using Branch Filters
      • Using Dynamic Configuration
      • Selecting a Workflow to Run
      • Installing and using docker-compose
  • Orbs
    • Using Orbs
      • Orb Introduction
      • Orbs Concepts
      • Orbs FAQ
    • Authoring Orbs
      • Intro to Authoring an Orb
      • Author an Orb
      • Orb Author FAQ
      • Orb Authoring Best Practices
      • Orb Testing Methodologies
      • Orb Publishing Process
      • Manual Orb Authoring
    • Tutorials
      • Using the Slack Orb
    • How-To Guides
      • Deploy Service Update to EC2
      • Notify a Slack Channel of a Paused Workflow
  • Insights
    • Overview
    • Metrics glossary
    • Insights snapshot badge
    • Test Insights
    • Data Partnerships
    • Insights API
  • Projects
    • overview
      • Projects Overview
      • Creating a Project
    • settings
      • Settings Overview
      • Enabling GitHub Checks
      • Adding SSH Keys
      • Open Source Projects
      • Using Notifications
      • Connect with JIRA
      • Managing API tokens
      • Status Badges
      • Webhooks
      • Using Credits
    • security
      • Security Features
      • Security Recommendations
      • Protecting Against Supply Chain Attacks
      • IP Ranges
  • Examples and Guides
    • Languages
      • Overview
      • Node
      • Python
    • Databases
      • Configuring Databases
      • Database Examples
    • Testing
      • Overview
      • Browser Testing
  • Deployment
    • Configuring Deploys
    • Deployment Examples
    • Deploying iOS applications
    • Upload to Artifactory
    • Publishing to Packagecloud
    • Google Cloud SDK
  • Reference
      • Configuration Reference
      • API v2 Reference
      • API v2 Introduction
      • API v2 Developer's Guide
      • API v1.1 Reference
      • Project Values and Variables
      • Prebuilt Images
      • Glossary
      • Help and Support
  • Server Administration v3.x
    • Server v3.x Overview
      • Overview
      • What's New in v3.x
      • Upgrade
      • FAQ
    • Server v3.x Install
      • Phase 1 - Prerequisites
      • Phase 2 - Install Core Services
      • Phase 3 - Install Execution Environment
      • Phase 4 - Post Installation
      • Migration
      • Hardening Your Cluster
    • Server v3.x Operations
      • Overview
      • Metrics and Monitoring
      • Introduction to Nomad
      • Configuring a Proxy
      • User Accounts
      • Managing Orbs
      • VM Service
      • Externalizing Services
      • Expanding Internal Database Volumes
      • Load Balancers
      • Authentication
      • Docker Authenticated Pulls
      • Build Artifacts
      • Usage Data
      • Security
      • Application Lifecycle
      • Troubleshooting and Support
      • Backup and Restore
    • Server v3.4.x PDFs
      • v3.4 Overview
      • v3.4 Installation Guide for AWS
      • v3.4 Installation Guide for GCP
      • v3.4 Operations Guide
    • Server v3.3.x PDFs
      • v3.3 Overview
      • v3.3 Installation Guide for AWS
      • v3.3 Installation Guide for GCP
      • v3.3 Operations Guide
    • Server v3.2.x PDFs
      • v3.2 Overview
      • v3.2 Installation Guide
      • v3.2 Operations Guide
    • Server v3.1.x PDFs
      • v3.1 Overview
      • v3.1 Installation Guide
      • v3.1 Operations Guide
    • Server v3.0.x PDFs
      • v3.0 Overview
      • v3.0 Installation Guide
      • v3.0 Operations Guide
  • Server Administration v2.x
    • Server v2.19.x Install
      • Overview
      • What's New in v2.19.x
      • Upgrade to v2.19.x
      • Updating Replicated
      • System Requirements
      • Prerequisites and Planning
      • Installation
      • Teardown
    • Server v2.19.x Operations
      • Overview
      • Intro to Nomad
      • Metrics & Monitoring
      • Nomad Metrics
      • Proxies
      • Docker Hub Pull Through Mirror
      • Authentication
      • VM Service
      • GPU Builders
      • Certificates
      • User Accounts
      • Build Artifacts
      • Usage statistics
      • JVM Heap Size
      • SSH Reruns
      • Maintenance
      • Backup and Recovery
      • Security
      • Troubleshooting
      • Faq
      • Customization & Config
      • Architecture
      • Storage Lifecycle
      • Acknowledgments
    • Server v2.19 PDFs
      • What's New in v2.19
      • v2.19 Installation Guide
      • v2.19 Operations Guide
    • Server v2.18 PDFs
      • What's New in v2.18
      • v2.18.3 Installation Guide
      • v2.18.3 Operations Guide
    • Server v2.17.3 PDFs
      • What's New in v2.17
      • v2.17.3 Installation Guide
      • v2.17.3 Operations Guide
    • Server v2.16 PDFs
      • What's New in v2.16
      • v2.16 Installation Guide
      • v2.16 Operations Guide
  • CircleCI Plans
    • Plan Overview
    • Free
    • Performance
    • Scale
    • Server

Sign Up and Try CircleCI

Last updated • Reading time
Last updated today • 1 min read
Tags Cloud

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

  1. 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.
    Sign up with GitHub
    • All Repos
    • Public Repos Only
    Sign up with BitBucket

  2. Type your GitHub or Bitbucket username, password, and two-factor authorization if applicable, then click Sign In/Login.

  3. Click the Authorize Application or equivalent button. The CircleCI Pipelines Dashboard appears.

  4. Use the Projects page of the CircleCI app to start building your project code.

Sign up with email

  1. Click Sign Up with Email.

    Sign Up with Email

  2. Enter your email address, and then set a secure password for your CircleCI account. A verification email is sent to the email address provided.

  3. Select the options that best describe you and your engineering organization.

  4. 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.


Creative Commons License
CircleCI Documentation by CircleCI is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.
On this page
  • Sign up with GitHub or BitBucket
  • Sign up with email
  • Terms
  • Next steps
circleci Docs
RSS Facebook Twitter GitHub Twitch LinkedIn
  • Terms of Service
  • Privacy Policy
  • Cookie Policy
  • Security
© 2022 Circle Internet Services, Inc., All Rights Reserved.
circleci

6,000 Minutes Free

CircleCI, now with more build minutes
than anyone else for FREE 🎉

Sign up for Free

These teams get it

CCI customer teams