This guide allows Ditto and Jamf 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 Jamf School and not with Jamf Now or other Jamf products.
Important first steps
The instructions below assume:
- Your Apple TVs are already enrolled in Jamf and Supervised
- VPP is configured and linked to Jamf
- 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 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 or Jamf School from the Apple TV MDM Type options
- Note the configuration code that appears
Step 2 - Deploy Ditto tvOS Receiver in Jamf
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
- Log in to your Jamf 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
- 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
- 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 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