Skip to content
Punch List app iconPunch List

MDM deployment guide

Deploy Punch List with Jamf Pro

Jamf Pro deploys the Punch List app and its enterprise license to your managed iPhones and iPads. You paste a short XML property list (plist) with one license key into the app record, and Pro unlocks automatically the first time each device opens the app.

Covers iOS and iPadOS.

Who this is for

Is this guide for you?

Apple-focused IT teams running Jamf Pro who need to unlock Punch List Pro across a managed iPhone and iPad fleet.

Before you start

Prerequisites

  • An active Jamf Pro tenant that can push managed app configuration to enrolled devices.
  • For iOS and iPadOS: an Apple Business Manager account, linked to your MDM, with the free Punch List app licenses acquired under Apps and Books.
  • Your Punch List license key, org ID, and org name from the setup email we send after purchase.
  • Network access from devices to https://api.mypunchlistapp.com, the only domain Punch List needs to reach.

Deployment

Push the license key with Jamf Pro

You set three key/value pairs on the Punch List app. Your MDM delivers them to every managed device silently, and the app reads them on launch.

  1. 1

    Add Punch List as a managed app

    In Jamf Pro, go to Devices, then Mobile Device Apps, and add a new App Store app. Search for Punch List, then set the distribution method that fits your environment (for example, Install Automatically).

  2. 2

    Scope the app to your device group

    On the Scope tab, add the smart group or static group of devices that should receive Punch List.

  3. 3

    Add the App Configuration property list

    On the App Configuration tab, paste the property list below, replacing the placeholder values with your license key, org ID, and org name from the setup email.

  4. 4

    Save and distribute

    Save. Jamf Pro begins distributing the app and configuration to in-scope devices on their next check-in, typically within a few minutes if devices are online.

The three configuration keys

Set these exactly. Key names are case-sensitive, lowercase, with underscores. The example values below use a fictional organization for illustration.

KeyTypeWhat to enterExample
license_keyStringYour license key from the setup emailpl_ent_acme_construction_a1b2c3d4e5f6
org_idStringYour org ID from the setup emailacme_construction
org_nameStringYour org name from the setup emailAcme Construction

Paste this property list into the App Configuration field, replacing the placeholder values with your own:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
  "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
  <dict>
    <key>license_key</key>
    <string>pl_ent_acme_construction_a1b2c3d4e5f6</string>
    <key>org_id</key>
    <string>acme_construction</string>
    <key>org_name</key>
    <string>Acme Construction</string>
  </dict>
</plist>

Important notes

  • Jamf Pro delivers managed keys as an XML property list (plist). Keep the key names exactly license_key, org_id, and org_name.
  • Android: Jamf's Android management runs through Managed Google Accounts with a different console layout. We have not verified the Punch List managed configuration path on Jamf's Android support, so rather than hand you steps that may not match your console, email support@mypunchlistapp.com and we will work through it with you.
  • Jamf Now (a different product from Jamf Pro) does not offer custom app configuration, so it cannot push the license key on any platform.

Verify

Confirm Pro unlocked on a test device

Before rolling out to your full fleet, test activation on a single device.

  1. 1Open Punch List on a test device that has received the app and configuration from your MDM.
  2. 2On first launch the app briefly shows "Activating..." while it validates the license, usually 1 to 2 seconds on a normal connection.
  3. 3After validation the app opens straight to the main screen. No sign-in, no purchase prompt, no license code to type.
  4. 4To confirm Pro is active, open Settings and check that it shows "Licensed by [your organization name]" with Pro features unlocked and no upgrade prompts.

If the app does not activate within 30 seconds of first launch, check that the device received the configuration and that the three keys have no typos or extra whitespace, then email support@mypunchlistapp.com with your org ID.

Troubleshooting

Jamf Pro FAQ

Where do I paste the license key in Jamf Pro?
On the Punch List app record, open the App Configuration tab and paste the XML property list with the three keys. Jamf Pro delivers it to the app as managed app configuration.
Can I deploy Punch List to Android with Jamf?
Jamf's Android management uses a different workflow that we have not verified for Punch List's managed configuration. Email support@mypunchlistapp.com before you start and we will help you work through it.
Can I use Jamf Now instead of Jamf Pro?
No. Jamf Now does not support custom app configuration, so it cannot push the license key. You will need Jamf Pro or another MDM that supports managed app configuration.
How do I confirm a device received the configuration?
In Jamf Pro, go to Devices, Search Inventory, open the device, and under Management, Mobile Device Apps confirm Punch List shows Managed status.

Ready to roll out Punch List?

Buy seats and get your license key, or talk to our team about your deployment.

Enterprise overviewTalk to sales
enterprise@mypunchlistapp.com

Using a different MDM? See all deployment guides.