CircleCI is always seeking ways to improve your experience with our platform.

To report a problem in the documentation, or to submit feedback and comments, please open an issue on GitHub.

Suggest an edit to this page (please read the contributing guide first).

This guide, as well as the rest of our docs, are open source and available on GitHub.

Take the build environments course with CircleCI Academy to learn more about choosing and using an executor.

Read more about Pre-built CircleCI convenience images for the Docker execution environment.

Jobs that require a macOS VM image ( macos) may use an Xcode version such as 12.5.1.

Jobs that require a complete Linux virtual machine (VM) image ( machine) may use an Ubuntu version supported by the list of available machine images.These images are not a full operating system, so they will generally make building your software more efficient.

The pre-built CircleCI Docker image from the CircleCI Docker Hub will help you get started quickly without learning all about Docker. Jobs that require Docker images ( docker) may use an image for Node.js or Python.A container or virtual machine is the term used for a running instance of an image. An image is a packaged system that has the instructions for creating a running environment. circleci/config.yml by specifying the executor type and an appropriate image. It is possible to specify a different executor type for every job in your. An executor defines the underlying technology or environment in which to run a job, and which image to use to best-suit your project. Each job defined in your project configuration is run in a separate execution environment, either a Docker container or a virtual machine.įor each job in your project config you will specify an execution environment by assigning it an executor. CircleCI offers several execution environments: Docker, Linux VM (virtual machine), macOS, Windows, GPU and Arm.

Windows docker on mac with gui