> ## Documentation Index
> Fetch the complete documentation index at: https://docs.revyl.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Toolchain Images

> Available remote build images and installed tools

A toolchain image is the runner setup for a build: the OS plus Xcode or the
Android SDK. Pin one when your build needs a specific version.

The configuration snippet below focuses on image selection. Keep the recipe's
runnable `app_id` and `output_path` alongside its `build_commands`.

## Selecting an image

If you don't pick one, the platform's current default is used. Pin an image in
config or per invocation:

```yaml theme={null}
build:
  framework: ios
  profiles:
    release:
      ios:
        build_commands: ["./scripts/build-release"]
        image: ios-macos-26-xcode-26.2
```

```bash theme={null}
revyl build --profile release --platform ios --remote \
  --image ios-macos-26-xcode-26.2
```

Image precedence is `--image`, then the selected recipe's `image`, then the
platform default. The special value `latest` uses the platform default. Image
selection affects remote execution only; the same recipe's commands and output
remain unchanged when it runs locally.

PR preview builds accept the same keys via the `image` field in the
[GitHub integration](/integrations/github) config.

## iOS images

<AccordionGroup>
  <Accordion title="ios-macos-26-xcode-27.0 (default)">
    | Tool | Version |
    | - | - |
    | Xcode | 27.0 |
    | Node.js | 22.23.0 |
    | npm | 10.9.8 |
    | Yarn | 1.22.22 |
    | pnpm | 11.9.0 |
    | Bun | 1.3.14 |
    | node-gyp | 13.0.0 |
    | CocoaPods | 1.16.2 |
    | git | 2.54.0 |
    | git-lfs | 3.7.1 |
    | ccache | 4.13.6 |
    | watchman | 2026.06.22.00 |
    | bash | 5.3.15 |
  </Accordion>

  <Accordion title="ios-macos-26-xcode-26.5">
    | Tool | Version |
    | - | - |
    | Xcode | 26.5 |
    | Node.js | 22.23.0 |
    | npm | 10.9.8 |
    | Yarn | 1.22.22 |
    | pnpm | 11.9.0 |
    | Bun | 1.3.14 |
    | node-gyp | 13.0.0 |
    | CocoaPods | 1.17.0 |
    | git | 2.55.0 |
    | git-lfs | 3.7.1 |
    | ccache | 4.13.6 |
    | watchman | 2026.07.27.00 |
    | bash | 5.3.15 |
    | Ruby | 4.0.7 |
    | Fastlane | 2.240.1 |
  </Accordion>

  <Accordion title="ios-macos-26-xcode-26.2">
    | Tool | Version |
    | - | - |
    | Xcode | 26.2 |
    | Node.js | 20.19.4 |
    | npm | 10.9.3 |
    | Yarn | 1.22.22 |
    | pnpm | 10.28.2 |
    | Bun | 1.3.8 |
    | node-gyp | 12.2.0 |
    | CocoaPods | 1.17.0 |
    | git | 2.55.0 |
    | git-lfs | 3.7.1 |
    | ccache | 4.13.6 |
    | watchman | 2026.07.27.00 |
    | bash | 5.3.15 |
  </Accordion>
</AccordionGroup>

## Android images

<AccordionGroup>
  <Accordion title="android-ubuntu-24.04-jdk-17-ndk-r27b (default)">
    | Tool | Version |
    | - | - |
    | Ubuntu | 24.04 (arm64, with Rosetta translation for x86\_64 binaries) |
    | OpenJDK | 17 (`JAVA_HOME` preset) |
    | Gradle | 9.4.1 (project `gradlew` wrappers also work) |
    | Gradle JVM defaults | 6 GB heap, 2 GB metaspace, exit immediately on JVM OOM |
    | Android platforms | android-33, android-34, android-35, android-36 |
    | Android build-tools | 33.0.2, 34.0.0, 35.0.0, 36.0.0 |
    | Android cmdline-tools | 14742923 |
    | Android platform-tools | latest at image build |
    | NDK | 27.1.12297006 (r27b) |
    | CMake | 3.22.1 |
    | ninja | Ubuntu 24.04 package |
    | Node.js | 22.22.2 |
    | npm | 10.9.4 |
    | Yarn | 1.22.22 |
    | pnpm | 10.33.3 |
    | Bun | 1.3.13 |
    | node-gyp | 12.3.0 |
    | Maestro | 2.5.1 |
    | git / git-lfs | Ubuntu 24.04 packages |
    | ccache | Ubuntu 24.04 package |
    | Python | 3.x (Ubuntu 24.04 package) |
    | Ruby | Ubuntu 24.04 package |
    | Fastlane | 2.240.1 |
    | bundletool | 1.18.3 |
  </Accordion>
</AccordionGroup>

## Need a different toolchain?

If your build needs an Xcode, JDK, NDK, or SDK version that isn't listed,
contact [support@revyl.ai](mailto:support@revyl.ai). New toolchain images are
published as additional keys.

## Related

* [Configuration](/remote-builds/configuration): where the `image` field lives
* [Caching](/remote-builds/caching): automatic compilation and configured path caches


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.