If it works in Docker, it works on CircleCI

Developers that build in Docker use CircleCI for maximum efficiency

The best tools for the job

The flexibility to choose the resource class that matches the CPU and RAM you need on each individual job.
Ship faster by completing runs on hundreds of Docker tasks at once using parallelism and test splitting.

Optimize developer time

Get faster image downloads using CircleCI’s pre-built Docker convenience images.
Docker layer caching means unchanged layers of your Docker image are reused and readily accessible for maximum speed.

Easily customize images

Tailor your execution environments by creating and using Docker images designed by your team.
Start with a pre-built convenience image and build your own image on top of it for complete customization.

How to run a Docker build on CircleCI

Step 1

Define a job in your configuration file

Step 2

Specify the Docker executor

Step 3

Select your Docker image. This can be a CircleCI convenience image or your own image

Step 4

Run your job! 🎉

Explore the docs

    
      
version: 2.1
jobs:
  my-job:
    docker:
      - image: cimg/base:stable
    steps:
      - checkout
      - run:
          name: say hello
          command: echo "hello!"
workflows:
  run-jobs:
    jobs:
      - my-job

Featured convenience images

CircleCI maintains a registry of pre-built Docker images. Our system allows images from outside of our registry but convenience images are built with CI/CD in mind: small, fast, and simple to download.

Browse the Developer Hub

See what our customers are saying about building with Docker on CircleCI

"From simple setup and easy integration across GitHub, Chat apps, Docker (and more) to the ability to deploy to different environments from production, QA, and staging, CircleCI has proven to be completely indispensable for our business."

Toshimasa Ishibashi
Co-founder and CTO, Kaizen Platform
"The fact is that in today’s world, companies need to make merge time to deploy time as short as possible. When looking for a CI solution that can scale really quickly, parallelize, distribute and optimize the run time in the split—and manage Docker as a first class citizen to help us manage the many systems inside — CircleCI comes out on top."

Rob Witoff
Former Director of Infrastructure & Security, Coinbase
"Workflows + Docker caching are great with CircleCI. I’m pumped about what we can do with this! Our Docker build times have gone from ~12 minutes to less than 2 minutes on CircleCI. Fan-freaking-tastic."

Josh Dover
Senior Software Engineer, CrateJoy

Expand your Docker knowledge

Check out these blog posts, tutorials, and videos to learn more about CI/CD tools for Docker development.

Ready to use Docker for CircleCI pipelines?

Follow this guide to successfully build Docker images, Dockerize apps, and test Docker containers.

Read the blog post

Just getting started with Docker?

This beginner’s tutorial has a step-by-step walkthrough of a config.yml file to help you start building, testing, and deploying your code with Docker.

Read the blog post

Start Building Now

Contact Us

How to get started with Docker images

Learn how to use pre-built Docker convenience images that can be pulled directly into your config.

Watch the video tutorial