Start Building for Free
  • xcode
  • Getting Started
  • How This Image Works
  • Image Tags
  1. Machine Images
  2. xcode



Our xcode machine image is available for those wanting to run macOS specific workloads on CircleCI. A number of images are available with Xcode preinstalled, and run in dedicated virtual machines on genuine Apple hardware.

This image contains the minimum tools required to operate a build on CircleCI (such as git) as well as extremely popular and useful tools in CircleCI (such as docker).

Getting Started

This image can be used with the CircleCI macos executor. For example:

1 2 3 4 5 6 7 jobs: build: macos: xcode: 15.3.0 steps: - checkout # Whatever you want to do

In the above example, the CircleCI Xcode image is used. More specifically, the tag 15.3.0 indicates the Xcode version. See how tags work below for more information.

How This Image Works

This image contains the macOS operating system and everything needed to run most builds on CircleCI. This includes but is not limited to:

  • Xcode
  • Fastlane
  • Ruby
  • Git
  • Docker and Docker Compose
  • The build-essential package containing compiling tools
  • jq
  • curl, ssh, and much more

Full software manifests for each image tag can be found in our documentation

Tagging Scheme

Images in this family are tagged by the Xcode version preinstalled.

Image Tags

  • 15.3.0
  • 15.2.0
  • 15.1.0
  • 15.0.1
  • 14.3.1
  • 14.2.0
  • 14.1.0
  • 14.0.1
  • 13.4.1
  • 12.5.1
Developer Updates
Get tips to optimize your builds
Or join our research panel and give feedback
By submitting this form, you are agreeing to ourTerms of UseandPrivacy Policy.