General FAQs

Why can't I log into my account?

You may find yourself seemingly locked out, or questioning if you're using the right Username & Password. More often than not, it's as simple as using the wrong domain.

Ensure that you’re utilizing the correct domain login, I.e. Individual vs Enterprise.

note

If your trial has been expired for longer than 30 days without purchasing a license, it will be deleted. This could also explain why you're having trouble logging in.

Individual Cloud Customer Domain

Use the following URL: https://app.corellium.com/login

Enterprise Cloud Customer Domain Determine your enterprise domain then access the URL in the following format: https://your_enterprise_domain.enterprise.corellium.com/login.

Who can use Corellium?

Corellium has a strict vetting process to ensure that our platform is exclusively used for legitimate and lawful purposes. Individuals, organizations, and people in countries that are sanctioned by the US government are not eligible to sign-up for Corellium. Additionally, we have never sold any devices or services to clients that are known or suspected of developing tools used in hacking campaigns against ordinary citizens, journalists, or activists, and will never do so.

You can read more about how we vet our customers on the Corellium Blog.

Where does the Files app store files?

Customers sometimes need to test apps that incorporate multimedia or other file upload.

iOS Files app

The path on iOS isn't consistent, but it can be easily found.

1. On iOS, open the Files app (not the Files tab on Corellium's web interface) and create a uniquely named directory. In our example, we use dirsearchtest123.
2. Open the Console tab on Corellium's web interface and search for the directory name.

   find / -type d  -name "dirsearchtest123" 2>/dev/null

3. You should see a response such as:

   /private/var/mobile/Containers/Shared/AppGroup/D66E0384-1D2E-4588-B8F9-6102D891808C/File Provider Storage/dirsearchtest123

Android Files app

On Android, the files are stored in the SD Card. Look in the appropriate directory under /mnt/sdcard/.

What is CorelliumD?

Corellium adds a daemon called corelliumd to Android and iOS devices. It also adds a helper application called com.corellium.CorelliumdHelper to Android devices.

The corelliumd daemon enables handy utilities such as keyboard passthrough for virtual devices, meaning you can type on your host keyboard and have it appear on the virtual device

These daemons also collect certain information from the VM to enable functionality for the Apps and Files features. This information is only used in Apps and Files and is not transmitted to Corellium.

iOS devices can be created without the corelliumd daemon, but Apps and Files will not be available on such devices.

Why am I seeing "Unknown Error has occured on this virtual device"?

This error typically occurs when the network settings aren’t quite right.

Please review our network setup guide.

Does Corellium offer some kind of jailbreak detection bypass?

We do not. Corellium VMs are inherently modified when compared to stock iOS, so jailbreak detection is likely to trigger on VMs. If you are testing on iOS 16 or earlier you can try using Shadow to bypass our Jailbreak; please note that Shadow is independently developed from Corellium, we will not be able to offer guidance on its use or implementation. If you are using a newer version of iOS, however, the recommended remedy is to remove any jailbreak detection code when running software on VMs.

How to find your UDID from an unsigned IPA

To find the provisioned device UDIDs from an .ipa, you can use the script below. Intended for macOS, leverages the macOS Security framework.

Simply put your .ipa somewhere on your local disk, and execute the script to extract the UDIDs.

./get_udids.sh /path/to/application.ipa

#!/bin/bash
# Extracts and displays device UDIDs from an IPA's provisioning profile (macOS only)
IPA=$1
PROVISION=$(unzip -Z1 "${IPA}" | grep embedded.mobileprovision)
if [ -z "${PROVISION}" ]
then
echo "[!] unable to find provisioning profile"
exit 1
fi
echo "[+] found provisioning profile at ${PROVISION}"
unzip -p "${IPA}" "${PROVISION}" | security cms -D > /tmp/embedded.mobileprovision
echo "[+] UDIDs:"
awk '/ProvisionedDevice/, /\/array/' /tmp/embedded.mobileprovision | awk -F'<string>|<\/string>' '$0=$2'
rm /tmp/embedded.mobileprovision

Why does the device screen keep disconnecting

Make sure that no other users are viewing the device at the same time. Currently, only one user can be connected to the device display at a time.

Why does my VPN keep disconnecting?

The VPN is only active when at least one device in the project is in the 'On' state. If all devices are off, or if no devices exist in the project, then the VPN will disconnect. It will reconnect when a device in that project turns on.

How do I check if Corellium's servers are operational?

You can check if the Corellium main website, platform components, and API are operational on our live StatusPage.

Sign up for notifications by email, text, Slack, Atom, or RSS. You will also find a link to our support page (which you're on now) where you can chat with a human.

I changed my IP settings but the server is still using my old IP settings

If you change your IP settings, you have to delete all existing projects. The IP ranges assigned to projects are determined at the time of the project’s creation, so the change in IP settings doesn’t propagate for projects already existing at the time of change.

How do I copy and paste to my virtual devices?

Due to limitations of specific browsers, pasting to a virtual device works in Safari but doesn’t work in Firefox, while copying from a virtual device works on Firefox but doesn’t work in Safari. Copy / Paste to and from the device works on Chrome.

How do I take screenshots?

You can simulate taking screenshots on both our iPhone and Android virtual machines.

iPhone Screenshots

You can take screenshots utilizing the button below the virtual device, once clicked the screenshot will be saved to your downloads folder.

You can also take screenshots utilizing AssistiveTouch from the interface of the virtual machine.

Alternatively, you take a screenshot using our API with the virtual hardware buttons. Please review our helpful Holding Down Two Virtual Hardware Buttons Corellium Support article.

Android Screenshots

1. Visit the Console screen
2. Hit Enter
3. Run input keyevent KEYCODE_SYSRQ. This will simulate a screenshot, and the image will be stored in Photos.

How do I execute multitouch commands?

note

There is no multitouch workaround for Android yet. If you know of one, please email [email protected].

For Apple devices, you can replicate multitouch commands via the built in accessibility tool:

1. Open the settings app.
2. Open Accessibility.
3. Scroll to Physical and Motor, Touch.
4. Select AssistiveTouch.
5. Turn on AssistiveTouch.

From here, you can also create custom actions and record new gestures to execute the commands you need. Once AssistiveTouch is active, all you need to do to execute these commands is to click the node and choose the command you need.

How do I simulate a panic?

To simulate a panic on an iOS device, open the Device's Console tab and run the following command:

simulatepanic

This will simulate a panic on the device. Alternatively, you can also simulate a panic by sending a signal to the init process. For example, you can run the following command:

kill -11 1

This sends the signal number 11 to the process with process ID 1. Signal number 11 is SIGSEGV, which stands for "segmentation fault." This signal typically indicates that a process has tried to access a memory segment that it's not allowed to, which often leads to the process being terminated abnormally.

Process ID 1 refers to the init process, which is the first process started during the booting of the system and has special responsibilities like managing other system processes. The init process is a critical component of the system, and it generally has protections against being terminated by signals that could disrupt system stability.

Do Corellium Android devices support AT commands?

We support the subset of AT commands that are needed by the Goldfish modem virtual hardware.

For more information, please see https://atcommands.org.

Please contact our support team to request support for additional commands.

Why doesn't Corellium work properly on my browser?

The Corellium platform currently supports the latest versions (evergreen) of:

• Apple Safari
• Google Chrome
• Mozilla Firefox
• Microsoft Edge

Other browsers may be supported, as long as they support H.264 video. However, we recommend using one of the browsers listed above for the best experience. It is possible that if you are using a beta release that is causing an issue. If this is the case, try a general release version of your browser.

Can I virtualize my IoT device?

Yes. Billions of IoT devices have drastically increased the demand for scalable and advanced security testing tools. That's why we’re offering custom device modeling services to IoT vendors, to create custom virtual models of everything from routers to smart speakers.

You can learn more about Custom Devices on Corellium or check out Arm Virtual Hardware.

Why is my app only partially rendering on my Apple device?

We see this happen with Flutter apps due to Corellium forcing software rendering instead of Metal rendering (currently unavailable in Corellium). It's possible this can be fixed by downgrading to an earlier version of Flutter with a more reliable software renderer. Please note that downgrading Flutter will likely require some rebuilding of your app.

Why can't I connect to my display?

For an optimal experience, please ensure you are using a supported browser. Additionally, certain enterprise network firewall settings can prevent the display from connecting properly, resulting in a black or grey screen.

Troubleshooting the WebRTC Connection

If you see a message saying "we cannot establish a webrtc stream," there is likely an issue with the STUN/TURN connections.

Follow these steps to troubleshoot:

1. Make sure the error reproduces across multiple supported browsers. (If the error is only occurring on certain browsers, try restoring the browser's default settings.)
2. Open Chrome with all other tabs closed and navigate to the built-in WebRTC analysis tool chrome://webrtc-internals.
3. On a new tab, log in to Corellium and open a device that is turned on.
4. After opening your device, you should see the WebRTC-Internals tab fill up with information.
5. Inspect the WebRTC-Internals results. If you notice any errors being reported on this page, please expand those events and investigate.
6. Save the results as a JSON file by clicking Create a WebRTC-Internals dump at the top-left then clicking the Download button. You can share this file with your IT department or with Corellium support for further troubleshooting.

In most cases, a firewall setting will block a particular port or range of ports that are required for our display server. Your network administrator may be able to assist in troubleshooting these network settings.

Additional Cloud Troubleshooting

This section is intended for customers using Corellium's Cloud SaaS solution.

Please check if your network firewall or proxy is blocking stun.corellium.com. TURN does not require any ports other than 80 and 443; however, certain types of network proxies can interfere with TURN.

If your firewall and/or proxy is blocking stun.corellium.com, you might see an Error 701.

STUN binding request timed out.
url: turns:stun.corellium.com, TURN allocate request timed out.
TURN host lookup received error.

Additional On-Site Troubleshooting

This section is intended for customers using an On-Site Corellium appliance.

Please confirm that the following ports are not blocked between the browser and the Corellium server:

• 22
• 443
• 8086
• 8088
• 27820
• 27821

Check the configuration

Your configuration is stored under /etc/turnserver.conf. Make note of your:

• realm, such as stun.corellium.abcdefg.com
• incoming-port, which defaults to 27820
• alternate-port, which defaults to 27821

Check the logs

Check the system logs for errors.

journalctl -u turnserver -S "1 hour ago"

You may see a response showing the realm, the local IP/port, and the remote IP/port:

May  3 21:48:24 abcdefg-1 turnserver: 365: session 000000000000000000: closed (2nd stage), user <webrtc:0000000000> realm <stun.corellium.abcdefg.com> origin <>, local 10.0.0.0:27820, remote 10.0.0.0:53046, reason: TCP connection closed by client (callback)

Why is my device screen flickering?

If you encounter your virtual iOS device screen constantly flickering you can resolve this by either pausing then unpausing the device or running the command:sbreload (reload the springboard) in the device console.

Why was my subscription cancelled?

​With upgrades to our platform we have also updated our billing. We appreciate your use of the Corellium platform, and we would like to make this transition as smooth as possible. Some plans have been discontinued and are officially retired now. Learn more details on Corellium new plans here.

To change your plan to Explorer or Professional Edition, please login to your Corellium account > Click Manage Subscription > Click Resubscribe > Select your new plan (Explorer or Professional) > Complete Subscription. If you are interested in Standard or Enterprise Edition plans for business, please let us know.

To avoid losing access to your account, please re-subscribe as soon as possible. If you have any difficulty re-subscribing, please reach out to Corellium Support and we will be happy to assist you.

Why was my trial request refused?

Corellium will deny trial requests for a number of reasons. Please select the Talk to a Person option to discuss your specific situation.

How do I rename my device?

To change your device's name, select your device so you are viewing the Device page, which has the console and visual device. Go to the Settings tab on the left side, type your preferred name in the Device name field, and press Enter to save.

How do I use Frida and Objection?

For ease of use, we’ve included a Frida daemon in all iOS and Android virtual models.

Corellium is also compatible with Objection, a runtime mobile exploration toolkit powered by Frida. You can either use the Corellium web interface, or you can connect directly to the frida-server through Terminal. Learn more about Frida on our support center.

Additionally, you can use our built-in Frida daemon or bring your own frida-server.

How do I install Linux on my M1 MacBook?

We're happy to see so much interest in porting Linux to the M1. This was a passion project from our developers who, similar to you, like to explore and tinker and push the boundaries of what was previously possible. You can learn more about the process in our blog post here.

Porting Linux to the M1 was released as a proof-of-concept, and not a project we're actively supporting.

What's the SSH password for the iPhone?

The default SSH password for iPhones and other iOS devices is "alpine".

How do I change my email?

As a security mechanism, if you want to change your email, the first step is verifying that you're the account owner. Please send an email to [email protected] from the email address currently registered requesting the change.

How do I take a screenshot?

Please see our Knowledge Base article about taking screenshots on iOS and Android here.

Do you support my country?

Corellium is not available in all countries for a variety of reasons. To see if your country is supported, please apply for a trial. If you would like us to add your country, please let us know!

Do you support Bluetooth?

We support Bluetooth Low-Energy (BLE) on Android virtual devices. For more information, please see our support article here.

How do I receive a free account?

Corellium offers subscription services as well as the option to host an on-site appliance, you can reach out to [email protected] for more information. However, we do offer a free trial which you are welcome to fill out a trial request form here. Keep in mind, all trial requests are reviewed by our team and will take some time to get back to you.

How does the pricing work?

You can find more information about our prices here.

How do I disable root access?

For iOS devices, Corellium supports both jailbroken and non-jailbroken iOS firmware. Likewise.

For Android devices, Corellium supports both devices with root access and with non-root access.

Can we have multiple administrators?

If you have an Individual account on our cloud platform, you cannot add any additional administrators. Enterprise customers on our cloud platforms are set up with one administrator by default. If you would like to add a secondary user, please have the current administrator contact our support team by email at [email protected].

If you are a customer with access to an on-premises Corellium server, please contact the support team by email at [email protected].

How do I contact the sales team?

If you would like to purchase an account outside of our standard trial process or would like a product demo, please email our the sales team at [email protected].

Can you help me jailbreak my iPhone?

We do not provide tools to jailbreak, root, or hack into physical devices. We at Corellium provide virtualized devices, not physical devices.

If you are interested in running virtual devices in a jailbroken or rooted environment, head over here to see how to get started.

How do I create a virtual device?

If you already set up your Corellium account and would like to create a new virtual device, please reference this article. If you have follow-up questions, please reference our Support Center Knowledge Base.

How do I download Corellium?

You cannot download the Corellium hypervisor to run on your local computer. Our system runs in the cloud on Arm servers in order to get the best virtualization possible. For large enterprise customers, we do offer an on-premises solution, which includes hardware and software for you to run locally. If you are a large enterprise and are interested in a quote, please email our Sales team [email protected].

When will my account expire?

If you are subscribed to Corellium, your account will say active as long as it's in good standing.

If you received your account from one of our partners training or educational programs, you will have to check that with your program's administrator.

If you would like to manually delete your account, you can do so from the admin panel.

When will the support team be available?

The support team is available to chat live during our regular business hours, Monday to Friday from 9am to 5pm EST, excluding holidays. Thank you for your patience.

How do I run Project Sandcastle?

We're happy to see so much interest in Project Sandcastle. This was a passion project from our developers who, similar to you, like to explore and tinker and push the boundaries of what was previously possible. You can access the source code here.

Project Sandcastle was released as an open-source prototype, a proof-of-concept, and not a product we're actively supporting.

How do I set up SSH keys?

Please follow this documentation to help you get started with SSH keys here.

On-site customers cannot use quickconnect, therefore SSH keys are not needed.

Does Corellium integrate with iCloud services?

Corellium does not support any Apple services, including but not limited to: iCloud, the App Store, iMessage, Siri, Apple Maps, etc. You may still access iCloud through Safari, but you are limited in what you are able to do. Learn more about our limitations here.

How do I install and run apps?

Corellium doesn't support the App Store, TestFlight, or any other Apple Services. In order to install an iOS app, you must have the IPA unencrypted and properly signed. If you want to install an app built in Xcode, you need to choose the "Ah Hoc" distribution method as well as making sure the Corellium device's UDID matches your provisioned devices associated with your Apple Developer account. Please review our knowledge base article.

Please note that Corellium does not support the Metal graphics framework, learn more about this here.

Installing Android apps is much simpler. You can install an APK directly to the device, or you can utilize OpenGApps to install applications listed on the Google Play store. Both of these methods are documented on our support center.

What is Corellium?

Here at Corellium, we provide access to virtualized devices that are accessible from any browser, no download required. In order to get started, you will need to request a free trial. Through our platform, you have the option to choose from wide range of iOS and Android models and firmwares. iOS devices can be created as jailbroken or non-jailbroken, while Android devices can only be created as rooted. We also have many Android models, but currently we only support creating rooted Android devices. The quickest way to get started virtualizing with Corellium, would be to sign up for a trial here.

I haven't received my trial.

All trial submissions are reviewed before we can provide you with access to our products. This process can take some time. While we try to respond to all trial applications within the same day, some application approvals might take 1-2 business days. You will receive an email from Corellium about whether or not your trial was approved or denied.

I want to buy a subscription.

In order to purchase a subscription, you will first need to fill out a trial form here. Then the trial form will determine what kind of account you are looking for. Once you have been given access to a trial, you can purchase a subscription at any time by logging into your account and navigating to Account > Subscription.

How do I reset my password?

The inability to sign in or reset your password can be caused by initially navigating to the incorrect URL. Please read below for the correct URL to visit for your account type.

For Business Accounts (Standard, Enterprise, Premium): Navigate to your domain-specific URL, for example https://your_domain_name.enterprise.corellium.com

For Individual Accounts (Explorer, Professional): Navigate to https://app.corellium.com

Once you are on the correct URL for your account type, click “Forgot Password?” and proceed. You should quickly receive your password reset e-mail.

How do I create a trial account?

Thanks for considering Corellium for your next mobile security research tool! You can sign up for a trial account here, with no download necessary to use our products!

How does the trial work?

You will have a number of days to use your allocated hours of device usage. You can see the remaining time left in your trial at the top of the Devices page. We hope you enjoy our products and look forward to working with you.