Docs
circleci.com
Start Building for Free

Dedicated Hosts for macOS

1 month ago1 min read
Cloud
On This Page

The dedicated host resource class is available for those developing, building, testing, and signing iOS, iPadOS, macOS, WatchOS, and tvOS applications using the Xcode IDE. These dedicated resources provide an isolated environment for increased security.

This resource class requires a 24-hour minimum lease and runs on Intel-based Mac hardware.

The identifier for the dedicated host resource is macos.x86.metal.gen1, and supports the same Xcode images as the other macOS resource classes, with the exception of Xcode 10.3. Refer to the Supported Xcode versions section of the Testing iOS page for the full list of versions.

Pricing and specs

ClassvCPUsRAMTotal StorageCost

macos.x86.metal.gen1

12

32 GB

200 GB

100 credits per minute (24-hour minimum)

Each account has a maximum of one dedicated host by default. You can increase the maximum number by contacting CircleCI support, or your account representative.

Once a dedicated host has been allocated, you have exclusive access to it for a minimum of 24 hours. If the dedicated host is already in use when a job is kicked off, the job is queued until the host becomes available, unless you have increased your dedicated host limit.

Known limitations

  • The resource class does not currently support test splitting or parallelism.

  • The host gets cleaned between jobs, which can currently take 5 to 45 minutes. We recommend running more than one dedicated host concurrently to help minimize the impact of this scrubbing process. Contact support or your account representative to increase your limit.

Example configuration file using macOS dedicated host resources

# .circleci/config.yml
version: 2.1
jobs:
  build-and-test:
    macos:
      xcode: 12.5.1 # indicate our selected version of Xcode
    resource_class: macos.x86.metal.gen1 # dedicated host, with 24-hour billing
    steps:
      - checkout
      - run: bundle install
      - run:
          name: Fastlane
          command: bundle exec fastlane $FASTLANE_LANE
      - store_artifacts:
          path: output
      - store_test_results:
          path: output/scan

workflows:
  build-test:
    jobs:
      - build-and-test

FAQ

Q: How does a dedicated host differ from the other macOS resources on CircleCI?

A: CircleCI’s other macOS resources are run on isolated virtual machines, which means that multiple customers can be using VMs on the same host. Dedicated hosts provide exclusive access to an entire host, without worrying about sharing resources with other customers.

Q: Why is there a 24-hour minimum?

A: Apple released an updated end-user license agreement (EULA) along with the release of Big Sur in November 2020, which requires cloud providers to lease Apple hardware to no more than one customer for a minimum of 24 hours.


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.

Need support?

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.