Deploying the Shade PKG to Jamf Pro

This guide walks through downloading the Shade installer package (PKG) and uploading it into Jamf Pro so it can be deployed to Macs.

circle-info

For the latest documentation, please refer to Jamf Pro's PKG Documentationarrow-up-right

Prerequisites

  • Access to Jamf Pro with permissions to upload packages (typically Jamf Pro Server Administrator or a role that can manage Packages).

  • A Mac with a browser that can download the installer.

    • If you are downloading the macOS app, Shade recommends using a browser other than Safari.

1) Download the Shade PKG

  1. Under Download Shade, choose the correct build for your Mac:

    • macOS (Apple Silicon) for M-series Macs (M1, M2, M3, M4)

    • macOS (Intel) for Intel Macs

  2. Download the installer file.

  3. Confirm the download completed and you have a single installer file to upload (for example, in Downloads).

  1. Verify you downloaded the correct architecture (Apple Silicon vs Intel).

  2. Make sure the file:

    • Opens or installs successfully on a test machine.

    • Has a reasonable file size (not suspiciously small).

  3. Rename the file to something clear and versioned (recommended), for example:

    • Shade-Desktop-<version>.pkg

3) Upload the PKG to Jamf Pro

  1. Sign in to Jamf Pro.

  2. Go to Settings.

  3. Navigate to the Packages section (sometimes listed under Computer Management depending on your Jamf Pro version).

  4. Click New or Upload (label varies by Jamf Pro version).

  5. In the upload form, select the Shade PKG you downloaded.

  6. Configure key Package Settings (common options):

    • Display Name: Use a clear name (for example, Shade).

    • Category: Optional, but helpful for organization (for example, Applications).

    • Priority: Keep the default unless you have multiple dependent packages.

    • OS Requirements: Set minimum macOS version if your environment requires it.

    • Architecture: If Jamf allows specifying it, match the package you downloaded (Apple Silicon vs Intel).

  7. Save.

  8. Wait for the upload to finish, then confirm the package appears in the Packages list.

4) Confirm the package is available for deployment

  1. Open the uploaded package in Jamf Pro.

  2. Confirm:

    • The package name and details look correct.

    • The package shows as successfully uploaded (no errors).

5) Next steps (optional): Deploy to devices

After the PKG is uploaded, you can deploy it using one of these approaches:

  • Policy: Install Shade on demand (Self Service) or automatically (recurring check-in, enrollment).

  • PreStage enrollment: Install during enrollment workflows.

If you tell me whether you want Self Service or silent install, I can add the exact recommended policy configuration to this page.

Last updated