Skip to content

macOS VMs

macOS Virtual Machines

It is possible to run macOS Virtual Machines (the same way one can run Linux containers) on the macOS Community Cluster. Simply use osx_instance in your .cirrus.yml files:

osx_instance:
  image: catalina-xcode

task:
  script: echo "Hello World from macOS!"

List of available images

  • catalina-base - vanilla macOS with Brew and Command Line Tools pre-installed.
  • catalina-xcode-NN - based of catalina-base with Xcode NN and couple other packages pre-installed: cocoapods, fastlane, rake and xctool.
  • catalina-xcode-NN-flutter - based of catalina-xcode-NN with pre-installed Flutter and Android SDK/NDK.

List of available Xcode versions:

  • 11.3.1
  • 11.4.1
  • 11.5
  • 12.0

Note that there are couple of aliases available for images:

  • catalina-xcode - point to the latest stable catalina-xcode-NN image.
  • catalina-flutter - point to the latest catalina-xcode-NN-flutter image.

Please refer to the osx-images repository on how the images were built and don't hesitate to create issues if current images are missing something.

Underlying Technology

Under the hood Cirrus CI is using Anka Cloud hosted on MacStadium for orchestrating macOS VMs. Please refer to the Anka documentation for more details.