## iOS 26 and more devices on Maestro Cloud

Support for iOS 26 is now available. `--device-os=iOS-26` works both locally and on Cloud. Use `--device-os=iOS-26-2` if you need a specific build. The iOS device catalog also got a significant expansion. iPhone 13 Mini and iPhone 16 Pro Max are in - two of the most requested models. Run `maestro list-cloud-devices --platform=ios` to see the full list.

* * *

## Know exactly which devices are available

Two new CLI commands return the exact values to pass into your flags. No more cross-referencing docs or guessing formats.

Copy

```
maestro list-devices
```

Copy

```
maestro list-cloud-devices
```

* * *

## Flag cleanup in maestro start-device

`--os-version` , `--android-api-level` , and `--ios-version` are deprecated. From now on, `--device-model` and `--device-os` are the only device-related flags you need, in `maestro start-device` and in `maestro cloud`. Same flags, same format, same values you get from `maestro list-devices`. If you use the list commands to pick your device, the output is already in the right format to paste directly into your command.

* * *

## New —device-os format

The flag now accepts strings instead of integers, matching the format `xcrun` and `avd` already use.

**Before** `--device-os=17` `--device-os=34`

**After** `--device-os=iOS-17-5` `--device-os=android-34`

If you want the latest available patch for a given major version, you can omit the minor version entirely. For example, `--device-os=iOS-18` will resolve to whatever the latest iOS 18 build is on that device. The same applies to Android: `--device-os=android-34` resolves to the latest available build for API level 34.

The old integer format still works for now. Support ends in the next release.

* * *

## Also in this release

- Web tests (Beta) now support iframes and `clearState`
- Faster feedback on `maestro cloud` uploads - more validation runs locally before hitting the network
- Better error messages when `startRecording` fails on iOS
- `setOrientation` now accepts variables as input
- Fixed `inputText` crashing on iOS pincode screens
- Fixed a websocket timeout that was set to 5000 seconds instead of 5000ms :)
- Fixed step ordering in the HTML test report
- Improved timeouts across all API calls, which helps with Maestro Cloud uploads
- Improved variable isolation and reduced memory usage in JavaScript evaluations
- Deprecation notice added to the legacy web-based Studio

* * *

## Update to 2.4.0

**macOS / Linux:**

Copy

```
curl -fsSL "https://get.maestro.mobile.dev" | bash
```

**Homebrew:**

Copy

```
brew update
brew upgrade mobile-dev-inc/tap/maestro
```