Skip to main content

Update iOS

Corellium supports updating an iOS device to later available versions.

Updating can be useful for testing how your application behaves on a newer version of the OS, or for testing how your application behaves when the OS is updated. For example, if you have a virtual iPhone 12 running iOS 14.1, you'll be able to upgrade to iOS 15.1.

Updating iOS includes support for installing pre-release (beta) versions.

Note: This feature is available to users with Business Enterprise licenses and higher.

Updating your OS version

Using the Corellium UI

To update your OS version, you will need to go to Settings > General in the Corellium UI. Scroll down to the section titled "Update iOS Version".

Upgrade Device Step 1

From here, select a version to upgrade to, then press "Save changes"

Upgrade Device Step 2

You'll be presented with a confirmation dialog. Press "Update" to continue.

Upgrade Device Step 3

Wait for the device to upgrade and reboot.

Upgrade Device Step 4

You'll be presented with a confirmation once the device has finished upgrading. Here, you'll see the device version has been updated.

Upgrade Device Step 5

Close the confirmation dialog and examine the toolbar to see the new version.

Using the Corellium API / SDK

To update your OS version, you can use one of the following endpoints from our various APIs and SDKs:

Example JavaScript

Here is an example of how to update an instance using the JavaScript API:

var { ApiClient, CorelliumApi } = require('@corellium/client-api');

var defaultClient = new ApiClient('');
// Configure Bearer (ApiToken or JWT) access token for authorization: BearerAuth
var BearerAuth = defaultClient.authentications['BearerAuth'];
BearerAuth.accessToken = '[access_token]';
// BearerAuth.accessToken = process.env.CORELLIUM_API_ACCESS_TOKEN;

var api = new CorelliumApi(defaultClient)

// var args = process.argv.slice(2);
var instanceId = '[instance_id]' // args[0]
var os = '16.1' // args[1]
var osbuild = '20B79' // args[2]

var instanceUpgradeBody = {

api.v1UpgradeInstance(instanceId, instanceUpgradeBody).then(() => {
console.log('API called successfully.');
}, (error) => {

Example Python

Here is an example of how to update an instance using the Python API:

import asyncio
import corellium_api
from import ApiException

# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.

# Configure Bearer authorization (ApiToken or JWT): BearerAuth
configuration = corellium_api.Configuration(
host = ""
ssl_ca_cert = "./ca_cert.cer"
configuration.access_token = '[access_token]'

async def main():
# Enter a context with an instance of the API client
async with corellium_api.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = corellium_api.CorelliumApi(api_client)
instance_id = '[instance_id]'

api_response = await api_instance.v1_upgrade_instance(instance_id, {
'os': '16.1',
'osbuild': '20B79'
except ApiException as e:
print("Exception when calling CorelliumApi->v1_upgrade_instance: %s\n" % e)


  • If you're on an on-site instance, the relevant IPSWs will need to be sourced on a network-enabled device then added to your on-site instance before updating. Learn more about adding firmware on our adding custom IPSWs article .
  • Updating an iOS device only works via the "restore" process - not "over the air" (OTA) updates.
  • When an iOS device is updated, the stock Apple apps (Mail, Reminders, etc.) are automatically scheduled for an update due to a conflict in their current app signatures and those stored in the Trust Cache. Until the update is complete, they are marked as invalidated by iOS. This is a normal process and does not affect the functionality of the device; however, it does mean you will need an internet connection to update the apps.
  • Application binaries can not be restored because they require an Apple account — same as for all Corellium virtual devices, there's no App Store access so you will need to source application binaries manually.