# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://academy.shade.inc/enterprise/deploying-the-shade-pkg-to-jamf-pro.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.