Menu

Using Pre-Built CircleCI Docker Images

As a convenience, CircleCI maintains a number of Docker Images for popular languages with additional tooling that is useful when running your tests. All of the following images are published in the CircleCI org on Docker Hub, the Dockerfiles and other source code is available in the repository on GitHub.

How to Get Started with Pre-Built Docker Images Video Tutorial

Available Images

Note: The language images are to be used as your primary container listed first in your config.yml file. The database images are best used as a secondary service container, in which case, list after the primary container image in your config.yml file.

Note: CircleCI maintains variants, which can be added to the main image name as follows:

  • -browsers: Includes browsers and libraries normally used for windowing

Note: If you choose to use the latest tag the image may change unexpectedly and create surprising results.


Clojure

Usage: Add the following under docker: in your config.yml:
image: circleci/clojure:[TAG] (Docker Hub page)
Available Tags:

  • boot

  • boot-2.7.1

  • boot-2.7.1-browsers

  • boot-browsers

  • latest

  • latest-browsers

  • lein

  • lein-2.7.1

  • lein-2.7.1-browsers

  • lein-browsers


Elixir

Usage: Add the following under docker: in your config.yml:
image: circleci/elixir:[TAG] (Docker Hub page)
Available Tags:

  • 1.2

  • 1.2.6

  • 1.2.6-browsers

  • 1.2-browsers

  • 1.3

  • 1.3.4

  • 1.3.4-browsers

  • 1.3-browsers

  • 1.4

  • 1.4.2

  • 1.4.2-browsers

  • 1.4-browsers

  • latest

  • latest-browsers


Go (golang)

Usage: Add the following under docker: in your config.yml:
image: circleci/golang:[TAG] (Docker Hub page)
Available Tags:

  • 1

  • 1.7

  • 1.7.5

  • 1.7.5-browsers

  • 1.7-browsers

  • 1.8

  • 1.8.1

  • 1.8.1-browsers

  • 1.8-browsers

  • 1-browsers

  • latest

  • latest-browsers


Java

Usage: Add the following under docker: in your config.yml:
image: circleci/openjdk:[TAG] (Docker Hub page)
Available Tags:

  • 6

  • 6b38

  • 6b38-browsers

  • 6b38-jdk

  • 6b38-jdk-browsers

  • 6-browsers

  • 6-jdk

  • 6-jdk-browsers

  • 7

  • 7-browsers

  • 7-jdk

  • 7-jdk-browsers

  • 7u121

  • 7u121-browsers

  • 7u121-jdk

  • 7u121-jdk-browsers

  • 8

  • 8-browsers

  • 8-jdk

  • 8-jdk-browsers

  • 8u121

  • 8u121-browsers

  • 8u121-jdk

  • 8u121-jdk-browsers

  • 9

  • 9-b168

  • 9-b168-browsers

  • 9-b168-jdk

  • 9-b168-jdk-browsers

  • 9-browsers

  • 9-jdk

  • 9-jdk-browsers

  • jdk

  • jdk-browsers

  • latest

  • latest-browsers


MongoDB

Usage: Add the following under docker: in your config.yml:
image: circleci/mongo:[TAG] (Docker Hub page)
Available Tags:

  • 3

  • 3.0

  • 3.0.14

  • 3.2

  • 3.2.13

  • 3.4

  • 3.4.4

  • 3.5

  • 3.5.6

  • latest

  • unstable


MySQL

Usage: Add the following under docker: in your config.yml:
image: circleci/mysql:[TAG] (Docker Hub page)
Available Tags:

  • 5

  • 5.5

  • 5.5.56

  • 5.6

  • 5.6.36

  • 5.7

  • 5.7.18

  • 8

  • 8.0

  • 8.0.1

  • latest


Node.js

Usage: Add the following under docker: in your config.yml:
image: circleci/node:[TAG] (Docker Hub page)
Available Tags:

  • 4

  • 4.8

  • 4.8.3

  • 4.8.3-browsers

  • 4.8-browsers

  • 4-browsers

  • 6

  • 6.10

  • 6.10.3

  • 6.10.3-browsers

  • 6.10-browsers

  • 6-browsers

  • 7

  • 7.10

  • 7.10.0

  • 7.10.0-browsers

  • 7.10-browsers

  • 7-browsers

  • argon

  • argon-browsers

  • boron

  • boron-browsers

  • latest

  • latest-browsers


PHP

Usage: Add the following under docker: in your config.yml:
image: circleci/php:[TAG] (Docker Hub page)
Available Tags:

  • 5

  • 5.6

  • 5.6.30

  • 5.6.30-apache

  • 5.6.30-apache-browsers

  • 5.6.30-browsers

  • 5.6.30-cli

  • 5.6.30-cli-browsers

  • 5.6.30-fpm

  • 5.6.30-fpm-browsers

  • 5.6.30-zts

  • 5.6.30-zts-browsers

  • 5.6-apache

  • 5.6-apache-browsers

  • 5.6-browsers

  • 5.6-cli

  • 5.6-cli-browsers

  • 5.6-fpm

  • 5.6-fpm-browsers

  • 5.6-zts

  • 5.6-zts-browsers

  • 5-apache

  • 5-apache-browsers

  • 5-browsers

  • 5-cli

  • 5-cli-browsers

  • 5-fpm

  • 5-fpm-browsers

  • 5-zts

  • 5-zts-browsers

  • 7

  • 7.0

  • 7.0.18

  • 7.0.18-apache

  • 7.0.18-apache-browsers

  • 7.0.18-browsers

  • 7.0.18-cli

  • 7.0.18-cli-browsers

  • 7.0.18-fpm

  • 7.0.18-fpm-browsers

  • 7.0.18-zts

  • 7.0.18-zts-browsers

  • 7.0-apache

  • 7.0-apache-browsers

  • 7.0-browsers

  • 7.0-cli

  • 7.0-cli-browsers

  • 7.0-fpm

  • 7.0-fpm-browsers

  • 7.0-zts

  • 7.0-zts-browsers

  • 7.1

  • 7.1.4

  • 7.1.4-apache

  • 7.1.4-apache-browsers

  • 7.1.4-browsers

  • 7.1.4-cli

  • 7.1.4-cli-browsers

  • 7.1.4-fpm

  • 7.1.4-fpm-browsers

  • 7.1.4-zts

  • 7.1.4-zts-browsers

  • 7.1-apache

  • 7.1-apache-browsers

  • 7.1-browsers

  • 7.1-cli

  • 7.1-cli-browsers

  • 7.1-fpm

  • 7.1-fpm-browsers

  • 7.1-zts

  • 7.1-zts-browsers

  • 7-apache

  • 7-apache-browsers

  • 7-browsers

  • 7-cli

  • 7-cli-browsers

  • 7-fpm

  • 7-fpm-browsers

  • 7-zts

  • 7-zts-browsers

  • apache

  • apache-browsers

  • cli

  • cli-browsers

  • fpm

  • fpm-browsers

  • latest

  • latest-browsers

  • zts

  • zts-browsers


PostgreSQL

Usage: Add the following under docker: in your config.yml:
image: circleci/postgres:[TAG] (Docker Hub page)
Available Tags:

  • 9

  • 9.2

  • 9.2.20

  • 9.2.20-alpine

  • 9.2-alpine

  • 9.3

  • 9.3.16

  • 9.3.16-alpine

  • 9.3-alpine

  • 9.4

  • 9.4.11

  • 9.4.11-alpine

  • 9.4-alpine

  • 9.5

  • 9.5.6

  • 9.5.6-alpine

  • 9.5-alpine

  • 9.6

  • 9.6.2

  • 9.6.2-alpine

  • 9.6-alpine

  • 9-alpine

  • alpine

  • latest


Python

Usage: Add the following under docker: in your config.yml:
image: circleci/python:[TAG] (Docker Hub page)
Available Tags:

  • 2

  • 2.7

  • 2.7.13

  • 2.7.13-browsers

  • 2.7-browsers

  • 2-browsers

  • 3

  • 3.3

  • 3.3.6

  • 3.3.6-browsers

  • 3.3-browsers

  • 3.4

  • 3.4.6

  • 3.4.6-browsers

  • 3.4-browsers

  • 3.5

  • 3.5.3

  • 3.5.3-browsers

  • 3.5-browsers

  • 3.6

  • 3.6.1

  • 3.6.1-browsers

  • 3.6-browsers

  • 3-browsers

  • latest

  • latest-browsers


Ruby

Usage: Add the following under docker: in your config.yml:
image: circleci/ruby:[TAG] (Docker Hub page)
Available Tags:

  • 2

  • 2.1

  • 2.1.10

  • 2.1.10-browsers

  • 2.1.10-node

  • 2.1.10-node-browsers

  • 2.1-browsers

  • 2.1-node

  • 2.1-node-browsers

  • 2.2

  • 2.2.7

  • 2.2.7-browsers

  • 2.2.7-node

  • 2.2.7-node-browsers

  • 2.2-browsers

  • 2.2-node

  • 2.2-node-browsers

  • 2.3

  • 2.3.4

  • 2.3.4-browsers

  • 2.3.4-node

  • 2.3.4-node-browsers

  • 2.3-browsers

  • 2.3-node

  • 2.3-node-browsers

  • 2.4

  • 2.4.1

  • 2.4.1-browsers

  • 2.4.1-node

  • 2.4.1-node-browsers

  • 2.4-browsers

  • 2.4-node

  • 2.4-node-browsers

  • 2-browsers

  • 2-node

  • 2-node-browsers

  • latest

  • latest-browsers

  • latest-node

  • latest-node-browsers