CircleCI remote Docker images support policy
On This Page
This document outlines the CircleCI remote Docker image release, update, and deprecation policy.
This policy applies to all CircleCI remote Docker images built for the remote Docker platform.
The CircleCI remote Docker images are based on our Linux VM images with Docker installed for the purposes of providing a remote environment that can execute Docker commands within jobs on the Docker executor.
We aim to support the latest two versions of the Docker Engine that are classified as within Security Support status.
We support various tags for the remote Docker environment to allow you to choose the type of remote Docker environment you require.
For the latest major version of Docker:
edge: This image is for testing purposes. It is updated frequently without warning and could include breaking changes.
current: This image is the current stable image. This is the default if no tag is selected.
previous: Once an
edgeimage is promoted to current, the previous
currentimage is moved to the
For the previous major version of Docker, we support a single tag following the format of
dockerXX, for example,
docker23 for Docker 23. This tag will point to the latest patch version of the major release, and will be updated if any patch versions are issued upstream.
Critical CVE patches
When critical CVEs are disclosed that affect the versions of the operating system or software stack in our remote Docker images, we will investigate the impact that this has on our images being used within the CircleCI execution environment.
In most cases, due to the ephemeral and isolated nature of the containers in the environment, it is not necessary to patch these images. We will always communicate our stance on these disclosures on our Discuss Forum.
Bug reports, issues, and PRs
You can file a support ticket with CircleCI Support for any issues or bugs found with the remote Docker images. Our support team will be able to escalate issues internally to the correct engineering team and provide updates on the issue.
Image lifespan / EOL
Image lifespan will generally follow the support status of Docker Engine by Docker. Once a new major version of Docker is released, we will begin the deprecation process of the oldest version that we support and schedule it to be removed. This allows us to maintain two versions of Docker Engine effectively.
Example: When Docker 25 is released:
When an image is selected for deprecation and removal, we will create an announcement on our Discuss forum, along with reaching out via email to developers who have requested one of the deprecated images in their recent jobs.
We will also plan brownouts to ensure users are aware of the approaching removal of deprecated images.
At any time, we reserve the right to work outside of the information in this document if the circumstances require. In the event that we are required to make an exception to the policy, we will aim to provide as much notice and clarity as possible. In these cases, an announcement will be posted on our Discuss Forum, along with additional outreach, such as an email notice, where possible.
Help make this document better
This guide, as well as the rest of our docs, are open source and available on GitHub. We welcome your contributions.
- Suggest an edit to this page (please read the contributing guide first).
- To report a problem in the documentation, or to submit feedback and comments, please open an issue on GitHub.
- CircleCI is always seeking ways to improve your experience with our platform. If you would like to share feedback, please join our research community.
Our support engineers are available to help with service issues, billing, or account related questions, and can help troubleshoot build configurations. Contact our support engineers by opening a ticket.
You can also visit our support site to find support articles, community forums, and training resources.
CircleCI Documentation by CircleCI is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.