If it works in Docker,
it works on CircleCI

Complete flexibility to run any Docker command so you can ship faster than ever before.

Start Building for Free Explore the Docs

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.

Docker (x86)

How to create a Docker (x86) job on CircleCI

Step 1

Define a job in your configuration file

Step 2

Specify the docker executor with the docker key

Step 3

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

Step 4

Choose a resource class or use the default

Step 5

Run your job 🎉

To build Docker images or use Docker commands, add the setup_remote_docker key to the job.

Get started now

    
      
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

Docker (Arm)

How to create a Docker (Arm) job on CircleCI

Step 1

Define a job in your configuration file

Step 2

Specify the docker executor with the docker key

Step 3

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

Step 4

Choose an Arm specific resource class

Step 5

Run your job 🎉

To build Docker images or use Docker commands, add the setup_remote_docker key to the job.

Get started now

    
      
version: 2.1
jobs:
  arm_example:
    docker:
      - image: cimg/base:2023.06
    resource_class: arm.medium
    steps:
      - run: echo "hello, world"

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
"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
"Since we implemented Docker layer caching, we’ve saved about 2,000 hours of developer time in the last six months. Likewise, our ability to turn around fixes has shortened by 50% or more."

Travis Mattera
Senior Site Reliability Engineer, Rollbar

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.