# Deploying the Shade PKG to Jamf Pro

{% hint style="info" %}
For the latest documentation, please refer to [Jamf Pro's PKG Documentation](https://learn.jamf.com/r/en-US/jamf-pro-documentation-current/Viewing_the_Contents_of_an_Indexed_Package)
{% endhint %}

#### 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. Open: <https://shade.inc/download>
2. 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
3. Download the installer file.
4. Confirm the download completed and you have a single installer file to upload (for example, in **Downloads**).

#### 2) (Recommended) Validate the package before upload

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.

#### Deploy via Self Service (On-Demand)

Use this method if you want Shade to be available in the Jamf Self Service app, allowing users to choose when to install it.

1. **Create a New Policy**: In Jamf Pro, go to **Computers** > **Policies** and click **New**.
2. **General Payload**:
   * **Display Name**: `Install Shade`
   * **Trigger**: None (Self Service policies do not require a system trigger).
   * **Execution Frequency**: `Ongoing` (this allows users to re-install the app if they move to a new machine or accidentally delete it).
3. **Packages Payload**:
   * Click **Configure** and find your uploaded Shade PKG.
   * Ensure the Action is set to **Install**.
4. **Self Service Payload**:
   * Click the **Self Service** tab at the top.
   * Check the box **Make the policy available in Self Service**.
   * **Self Service Display Name**: `Shade`
   * **Button Name**: `Install`
   * **Description**: Provide a brief description (e.g., "Shade is your creative asset manager...").
   * **Icon**: Upload the Shade application icon for a professional look.
5. **Scope**:
   * Click the **Scope** tab.
   * Add the specific computers or Smart Groups (e.g., "All Managed Clients") that should see Shade in their Self Service catalog.
6. **Save**.

***

#### Deploy via Silent Install (Automatic)

Use this method if you want Shade to be installed automatically on background Macs without any user interaction.

1. **Create a New Policy**: In Jamf Pro, go to **Computers** > **Policies** and click **New**.
2. **General Payload**:
   * **Display Name**: `Deploy Shade - Automatic`
   * **Trigger**: Select **Recurring Check-in** (this is the standard trigger for silent background deployments).
   * **Execution Frequency**: Select **Once per computer**.
3. **Packages Payload**:
   * Click **Configure** and find your uploaded Shade PKG.
   * Ensure the Action is set to **Install**.
4. **Maintenance Payload**:
   * Click **Configure** and check the **Update Inventory** box. This ensures that Jamf knows the app is installed immediately after the policy runs.
5. **Scope**:
   * Click the **Scope** tab.
   * Add the computers or Smart Groups that require Shade.
   * *Tip: Use a Smart Group that targets computers where "Shade.app" is not currently installed.*
6. **Save**.

***

#### Verify Deployment

After saving your policy, you can monitor its progress:

* **Logs**: Open the policy in Jamf Pro and click the **Logs** button at the bottom right. This will show you which computers have successfully installed the package and which are still pending.
* **Inventory**: Check an individual computer’s inventory record under **Applications** to confirm `Shade.app` appears in the list.

#### Troubleshooting Tips

* **Architecture Mismatch**: If a silent install fails, verify that you haven't deployed an Intel PKG to an Apple Silicon (M1/M2/M3) Mac.
* **File Vault**: If you are deploying during Enrollment (PreStage), ensure the "Fill User Template" or "At Restart" options are NOT selected, as Shade should be installed into the `/Applications` folder normally.