This guide allows Ditto and Jamf Pro administrators to zero-touch deploy the Ditto tvOS Receiver across multiple supervised Apple TVs simultaneously. Please note this process only works with Jamf Pro and not with Jamf Now or other Jamf products.
Important first steps
The instructions below assume:
- Your Apple TVs are already enrolled in Jamf Pro and Supervised
- VPP is configured and linked to Jamf Pro
- You've correctly configured your network for use with Ditto
If you aren't sure how to perform these steps, check out the Additional Jamf Help tab above.
Deploying Large Numbers of Receivers?
Parts of this processs can be automated even further. Please contact your Ditto account representative for additional Windows deployment options before continuing.
Step 1 - Preconfigure Jamf Pro in Ditto
- Log in to the Ditto Account Portal
- Navigate to the My Organization area
- Select Deployment
- Select the Ditto tvOS Receiver tab
- Select Jamf Pro from the Apple TV MDM Type options
- Note the configuration code that appears
Step 2 - Deploy Ditto tvOS Receiver in Jamf Pro
Assign Ditto Receiver licenses with VPP
In the Apple business/education Portal (bussiness.apple.com or school.apple.com):
- Click "Apps and Books" under Content
- Search for "Ditto Receiver" and select it
- In the right column under "Buy Licenses"
- Assign to desired company location
- Choose the quantity desired and click "Get"
- After a few moments the total under "Manage Licenses" should update to the reflect the quantity
Deploy Ditto Receiver with Jamf Pro
- Log in to your Jamf Pro portal
- Click the Devices tab
- Select Mobile Device Apps
- Click the "+ New" button at the top right of the list
- On the "Choose an App Type" screen, select "App Store app or VPP store app" and click "Next"
- Enter "Ditto Receiver" in the search box and press "Next"
- Select the "VPP Store Apps" tab
- Click the "Add" button beside Ditto Receiver
- Ensure the Site is set to the same site as the Apple TV(s) you're deploying Ditto Receiver to
- Set the Distribution Method to "Install Automatically/Prompt Users to Install"
- Check "Automatically Force App Updates"
- Check "Make app managed if currently installed as unmanaged"
- Navigate to the Scope tab
- Click the "+ Add" button and add the Apple TV(s) you're deploying Ditto Receiver to
- Navigate to the “App Configuration” tab
- Copy the App Config for your organization from the Ditto Portal (found in step one above) and paste it in the Preferences box
- Click Save and then Done
- After a moment, Ditto Receiver should begin automatically installing on the Apple TV(s) You can now return to the Ditto Portal and assign these receivers to rooms
Step 3 - Link Devices to Rooms in Ditto
At this point, your Apple TVs are now configured and paired to your Ditto account. You now need to link the receivers you just created to rooms in your Ditto Account Portal in order to complete your setup. Follow the steps in the option that applies to you.
Option 1: If you haven't yet created rooms in the Ditto Account Portal, follow these steps:
- Return to the Ditto Account Portal
- Navigate to the Rooms section
- Create a room for each receiver you added through Jamf Pro
- Ditto is now ready to use with your Apple TV. Users can now mirror their screens using Ditto Connect.
Option 2: If you already created rooms in the Ditto Account Portal, follow these steps to rapidly link them to receivers:
- Return to the Ditto Account Portal
- Navigate to My Organization section
- Select Deployment
- Click the Ditto tvOS Receiver tab
- Under Quick Link Rooms, select Begin Linking and you will be presented with a list of unlinked receivers added through Jamf Pro
- Select the room each receiver should be assigned to from the drop down beside the receiver name
Step 4 - Lock tvOS into Ditto
The following steps are not required, but we highly recommend them for the best Ditto experience.
- Log in to your Jamf Pro portal
- Select the Devices tab in the menu
- Select Configuration Profiles
- Click the "+ New" button at the top right of the list
- Enter a name for the configuration profile
- Set the site to the same one you deployed Ditto Receiver to
- Select "Single App Mode" from menu at the left and click Configure
- Set the Targeted Operating System to tvOS
- Under Lock to App, select "Specify Bundle ID"
- Enter "com.squirrels.dittoatv2" for the Bundle ID
- Select "Restrictions" from the menu at the left and click Configure
- Select the tvOS tab
- Uncheck the Allow AirPlay box
- Select the Scope tab above the menu at the left
- Add the Apple TVs running Ditto Receiver
- Click Save