Menu

Getting Started with CircleCI

Setting up CircleCI usually takes only three mouse clicks:

  1. Sign up with CircleCI
  2. Give CircleCI permission to access GitHub or Bitbucket on your behalf
  3. Click on a project

It really is that easy for about 90 percent of our users.

The reason it’s so easy is that we automatically infer your settings from your code. We expect you to have a project that roughly follows best practices for your platform. If you do, your tests will be up and running in a flash. Add your first project now!

When the magic doesn’t work?

Of course, life is not always sunshine and daisies. Sometimes your tests will fail, CircleCI won’t infer your custom setup, or our inference won’t be aware of your test suite. Here are some common issues and where you can find their fixes.

What next?

Add your colleagues

Testing is no fun if you’re the only one playing. To add your colleagues, simply ask them to join CircleCI. We use GitHub or Bitbucket permissions for all projects, so if they have access to your project on GitHub or Bitbucket, they’ll have access on CircleCI, too.

One of the best things about CircleCI’s design is that you have your own account, which in turn enables CircleCI to send you personalized emails only for the branches you use.

Add and follow more projects

No matter if you commit to a project only once a month or if a project is just getting started, adding it to CircleCI will help keep it on track.

Adding a project refers to the first time the project is setup on CircleCI. (Related:  What happens when you add a project?) Add projects by clicking the Add Projects button on the Project page in the CircleCI app.

Following a project subscribes you to email notifications and adds the project into your dashboard’s project/branch picker. CircleCI users that push to a new project get automatically followed to the project. You can control which projects you follow (including following projects that you do not push to!) from the Projects > Add projects page.