Use CircleCI to build custom Docker images with combinations of common languages/dependencies
Switch branches/tags
Nothing to show
Clone or download
Latest commit e487ed0 Apr 27, 2018
Failed to load latest commit information.
.circleci Add Dockerize Apr 24, 2018
img line breaks, imgs, etc Dec 28, 2017
scripts Merge pull request #16 from aderyabin/feature/dockerize Apr 27, 2018
.gitignore try bats Jan 2, 2018
Makefile refactoring, etc Jan 2, 2018 Update Jan 8, 2018

CircleCI Dockerfile Wizard

Easily build Docker images with different versions/combinations of common languages/dependencies, for use on CircleCI.



1. Fork this repository and start building it on CircleCI:

Setup Project

2. Add your Docker Hub username (DOCKER_USERNAME) and password (DOCKER_PASSWORD) to CircleCI, either as project-specific environment variables (shown below), or as resources in your org-global (default) Context

Environment Variables

3. Clone your fork of the project onto your computer

4. Enter the cloned dockerfile-wizard directory and run make ready to prepare the config.yml file for building Docker images on CircleCI

5. Run make setup in the cloned directory, or else manually add the versions/dependencies that you need to .circleci/config.yml as specified in the image_config section

6. Commit and push your changes

Once the build has finished, your image will be available at and can be used in other projects building on CircleCI (or anywhere else!). The Dockerfile for your image will be stored as an artifact in this project's build job.

To use the Dockerfile Wizard again, run make reset in the cloned directory, then repeat steps 4-6.

How it works

  1. The setup script adds your requested version information to the config.yml file as environment variables
  2. The script runs on CircleCI and generates a Dockerfile based on those environment variables
  3. CircleCI builds your Docker image from the generated Dockerfile, deploys it using your Docker credentials, and then tests your image using Bats, which we install in every Docker image built via this repository


  • The portions of this repository that run on your local computer are intended for Linux/macOS operating systems; they may not work on Windows
  • This repository has not been tested with every possible permutation of versions/dependencies, and you may encounter errors with some combinations of various languages/tools. If your build job fails, check its docker build step—there's likely a compilation error with a particular version of Ruby, Node, or Python.
  • Thanks to jmason for the tap-to-junit script!
  • Feedback/questions/bugs welcome!
  • Want to do all this yourself? Check out our video on creating custom Docker images for CircleCI


  • Add PHP support
  • Add support for other container registries