Skip to content

Getting Started with Exodus

Exodus is designed to help you migrate your devices from an EMM to another EMM in the most frictionless way possible.

It streamlines the processes for both the IT Team in charge of the migration but also the end-users of which devices must be migrated. This document will help you grasp the essentials about Exodus.

Signing in

You can connect to your Exodus dashboard by authenticating with your email address.

  • Access your personal Exodus login page with the URL we provided you
  • Enter your email address
  • Enter your password
  • Click on Sign in

Note

You are now signed in your dashboard, from where you can initiate and manage your migrations.

Creating a new migration from your dashboard

You can create a new migration from your Exodus dashboard.

  • Once signed in, click on the blue New Migration button, located on the top right corner of your dashboard
  • Migration Name: give your migration a name and a quick description, then click on “Next”
  • Source: in that step, you need to provide few elements about your source environment. Those elements are:
    • The EMM server type (if several are supported)
    • A list of specific fields which depends on the EMM server type chosen above.
    • If you have any iOS devices assigned in Apple DEP (Device Enrollment Program), you must choose whether you want to initiate a Device Wipe on those devices (Official workflow) or not (Exodus Legacy workflow).
    • If you wish to migrate your compatible Android devices (i.e. Android 6+) to an Android Enterprise fully managed environment.

Hint

For further information about the required source environment’s fields, please read Required environment’s information.

For further information about the DEP related options, please read the DEP Workflow section.

For further information about the Android Enterprise fully managed options, please read the Android Enterprise Workflow section.

  • Click on Next to get to the Target step: you now need to provide elements about your target environment. Like previous step, those elements are:
    • The EMM server type (if several are supported)
    • A list of specific fields which depends on the EMM server type chosen above.

Hint

For further information about the required target environment's fields, please read Required environment’s information.

  • Click on Next to get to the Summary step: you can see the name of the migration, the date it was created, information about the host source and information about the host target, and a quick description.

Caution

Please pay attention to those details and make sure that they are correct.

  • Click Save. Exodus will then look up for both environment and see if:
    • It can access it
    • It sees all the devices
    • It sees if the instance is correctly set up for everything

Note

It may take a bit of time, depending on the number of devices you’re about to migrate.

If your migration includes any DEP devices, you'll need to do some additional steps before you can start the migration of those devices. See the corresponding section in the Apple DEP Guide for more details.

  • Your migration is now ready to begin.
  • You now have the option to either click on the Start all ready devices button to start the migration of all your ready devices at once, or selectively start each of them one by one or in bulk using the corresponding button in the device list below (see Console Guide for more details).

The Exodus Companion App shall now be used on the concerned devices to un-enroll and re-enroll them to the new EMM platform.

Hint

Please read Un-enroll and re-enroll your devices with the Exodus Companion App to learn more about this step.

Un-enroll and re-enroll your devices with the Exodus Companion App

Once you have created a migration from your dashboard, the concerned devices need to execute the Exodus Companion App to un-enroll and re-enroll the devices.

Hint

To learn how to get the Exodus Companion App, please read Get the Exodus Companion App on your devices.

There are two possible workflow here: wipe workflows and non-wipe workflows

Non-wipe workflow

  • Launch the Exodus Companion App on the device where you are invited to start a migration.
  • Click on Start Migration.
  • A pop-up window informs you that you cannot cancel the migration once you started it. Please pay attention to the message, and if you are ready to start the migration, click on OK.
  • The application will check if everything is correct in terms of data connectivity, of battery level and if it can authenticate on the Exodus server. If everything is fine, the un-enrollment will start automatically.

Caution

If the application reports an error, please read Troubleshooting Exodus Companion App initialization.

  • Now click on Finish migration to start the re-enrollment phase. The re-enrollment phase includes different steps outside of the Exodus Companion App which are either EMM or Operating System dependant and varies if the device runs Android or iOS. Please make sure to follow the steps thoroughly.
  • Once done, you have completed your migration and your device is now successfully enrolled in your target EMM. The app prompts you to remove it from the device.

Wipe workflow

  • Launch the Exodus Companion App on the device where you are invited to start a migration.
  • Click on Erase Device.
  • A pop-up window informs you that you are about to erase all your data on the device. Please pay attention to the message, and if you are ready to start the wipe, click on OK.
  • Once the device restarts, your migration is complete and your device is now successfully enrolled in your target EMM.

Required environment's information

These instructions depend on the type of EMM you're using. Please choose the appropriate one in the list below:

Important

Before proceeding, please make sure that your Exodus instance supports your EMM servers' versions as source and/or target in the support matrix page

Get the Exodus Companion App on your devices

Here again, it differs related to your EMM. Please choose the appropriate one in the list below:

Troubleshooting Exodus Companion App initialization

When starting a device migration with the Exodus Companion App, the app will first try to check the device to make sure the migration can be safely executed. If something goes wrong, the app will let you know with an error alert.

If you are facing this case, please read the following part:

Something went wrong during your device status check. Please make sure you have your cellular data activated or access to internet via WiFi before trying again.

If you see this message, it means that your device doesn’t have an access to internet. Go to the device settings and make sure the device have a functional cellular connection or a functional Wifi connection and is not in airplane mode. If you’re struggling with this part, please report to the device’s documentation.

Something went wrong during your device status check. Please make sure your device has more than 30% battery level before trying again.

If you see this message, it means that the battery level of your device is too low. For safety reasons, you cannot start a migration if the battery level isn’t at least of 30%. Plug your device and start again once the battery level is above 30%.

There is no ongoing migration for your device yet.

If you see this message, it means that no migration is set for this device. If you think there should have one, please try again. If the error message persists, tap the little circled i in the top right corner and check that the Exodus server is correctly set (you may need the help of your IT department to know if the value is correct).

To know more about how to create a migration, please read Creating a new migration from your dashboard.