Skip to content

Prerequisites for Jamf Pro as Source

Required environment’s information

You need to first setup all general prerequisites before proceeding to this guide.

Mobile Device requirements

In order to migrate your mobile devices, Exodus needs to know the email address of the user who possess the device.

The email address is needed to contact the user and register the mobile device with the appropriate information (on supported EMM environments).

Warning

Mobile devices that don't have an email address cannot be migrated by Exodus.

Get the Exodus Companion App on your devices

You can deploy the Exodus Companion App via Volume Purchase Program (or VPP) or as a Public App. We strongly recommend leveraging VPP as this method won't require of the users to authenticate with an Apple ID.

Via VPP

This program is managed from the Apple Business Manager portal.

Please consult Jamf Pro Documentation for more information about Volume Purchasing integration, service token and licences assignment.

When the required Exodus Companion App licences are purchased and assigned, you need to configure a Volume Purchasing location on Jamf Pro.

  • From the top-right corner of the Jamf Pro console, click the Settings icon > Global Management > Volume Purchasing > Click on + New to create a new location.

  • Provide a Display Name then click on Upload Service Token to upload the service token (.vpptoken) you have downloaded from Apple Business Manager. Once done, Save the location.

Then in the Content tab, verify that the Exodus Companion App is correctly listed.

As a Public App

You need to add the Exodus Companion App from the App Store to your Source Tenant’s app catalog.

From the Jamf Pro console, click on Devices > Mobile Device Apps > New > select App Store app or apps purchased in volume > click Next.

In the search field, enter Exodus Companion, and click Next then Add.

Figure: Search App

Exodus Companion app: Search app

Figure: Add App

Exodus Companion app: Add app

General

In the General tab, make sure the following settings are configured:

  • Distribution Method is set to "Install Automatically/Prompt Users to Install".
  • Make app managed when possible is enabled.
  • Make app managed if currently installed as unmanaged is enabled.
  • Remove app when MDM profile is removed is disabled.

Figure: General

Exodus Companion app: General

Scope

Configure the Scope so that the application is distributed to all your migrated mobile devices.

Managed Distribution

If you are using Apple Volume Purchase Program (VPP) to distribute the Exodus Companion app to your users, check Assign Content Purchased in Volume in the Managed Distribution tab, and select a Volume purchasing location.

App Configuration

In the App Configuration tab, enter the following app configuration:

<dict>
    <key>server-url</key>
    <string>https://{{your-instance}}-api.exodus.tools</string>
    <key>serial-number</key>
    <string>$SERIALNUMBER</string>
</dict>

Replace {{your-instance}} with the identifier of your Exodus instance.

Example

If your Exodus instance is example.exodus.tools, the server-url property should be set to https://example-api.exodus.tools.

Figure: App Configuration

Exodus Companion app: App Configuration

Then Save the changes.