NAV

CircleCI Images

CircleCI maintains a number of Docker images that are, generally, supersets of official images for popular languages with additional tooling useful when running your tests.

For many of them we also have the following variants, which can be used by adding the suffix to the main image name (each of which is listed in the tags for each image below, when available):

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

All of the following images are published in the CircleCI org on Dockerhub.

NOTE: We strongly recommend that you lock your image to a particular tag to avoid unwanted changes (the available tags for each image are listed below and available on each images Dockerhub page). If you choose to use the latest tag the image may change unexpectedly and create surprising results.

Available Images

Note: The ‘language’ images would usually be used as your ‘primary’ container. The ‘database’ images are best used as a secondary ‘service’ container.


Clojure

Usage: Add the following under docker: in your config.yml:
image: circleci/clojure:[TAG] (Dockerhub 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


Go (golang)

Usage: Add the following under docker: in your config.yml:
image: circleci/golang:[TAG] (Dockerhub 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


MongoDB

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

  • 3

  • 3.0

  • 3.0.14

  • 3.2

  • 3.2.12

  • 3.4

  • 3.4.3

  • 3.5

  • 3.5.6

  • latest

  • unstable


MySQL

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

  • 5

  • 5.5

  • 5.5.55

  • 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] (Dockerhub page)
Available Tags:

  • 4

  • 4.8

  • 4.8.2

  • 4.8.2-browsers

  • 4.8-browsers

  • 4-browsers

  • 6

  • 6.10

  • 6.10.2

  • 6.10.2-browsers

  • 6.10-browsers

  • 6-browsers

  • 7

  • 7.9

  • 7.9.0

  • 7.9.0-browsers

  • 7.9-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] (Dockerhub 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] (Dockerhub 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] (Dockerhub 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] (Dockerhub 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