> ## Documentation Index
> Fetch the complete documentation index at: https://docs.enlazosystems.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Microsoft Intune

> Deploying Proximos, its settings .plist file, PPPC profile, and launch agent via Microsoft Intune.

## Deploying the Proximos Application

**Option A — PKG:**

1. Retrieve the latest [Proximos `.pkg` file](https://files.enlazosystems.com/Proximos/Proximos.pkg) (this link always hosts the latest version).
2. Go to **Apps → macOS → + Create**, then set **App type** to **Other → macOS app (PKG)**.
3. **Step 1:** Upload `Proximos.pkg`. Optionally change the name or description and add the Proximos logo. Enter the **Publisher** as "Enlazo Systems LLC." Click **Next**.
4. **Step 2:** Skip the Pre-install and Post-install scripts. Click **Next**.
5. **Step 3:** Set the **Minimum operating system** to macOS High Sierra 10.13. Click **Next**.
6. **Step 4:** Set **Ignore App Version** to **Yes**. The **App Bundle ID** should auto-detect as `com.enlazo.proximos`. Click **Next**.
7. **Step 5:** Under **Assignments**, assign to your devices using your custom groups, users, or devices. Click **Next**.
8. **Step 6:** Review, then click **+ Create**.

**Option B — DMG:**

1. Retrieve the latest [Proximos `.dmg` file](https://files.enlazosystems.com/Proximos/Proximos.dmg).
2. Go to **Apps → macOS → + Create**, then set **App type** to **Other → macOS app (DMG)**.
3. **Step 1:** Upload `Proximos.dmg`. Optionally change the name or description and add the Proximos logo. Enter the **Publisher** as "Enlazo Systems LLC." Click **Next**.
4. **Step 2:** Skip the Pre-install and Post-install scripts. Click **Next**.
5. **Step 3:** Set the **Minimum operating system** to macOS High Sierra 10.13. Click **Next**.
6. **Step 4:** Set **Ignore App Version** to **Yes**. Confirm the **App Bundle ID** is `com.enlazo.proximos` and the **App version** is set to the current version. Click **Next**.
7. **Step 5:** Under **Assignments**, assign to your devices using your custom groups, users, or devices. Click **Next**.
8. **Step 6:** Review, then click **+ Create**.

**Option C — Installation Script:** Wraps an App install as an Intune shell script which always installs the latest version. This can be less maintenance than maintaining a current .DMG or .PKG file in Intune.

1. Go to **Devices → macOS → Scripts → Add**.
2. **Step 1:** Name the script "Proximos App."
3. **Step 2:** Upload the `Proximos Install or Update.sh`  script, found in the **Extras → Deployment Scripts** folder inside [`Proximos.dmg`](https://files.enlazosystems.com/Proximos/Proximos.dmg). Set **Run script as signed-in user** to **No**. Set the **Script frequency** to **Every 1 week** if you want the app to update weekly. Set **Max number of times to retry if script fails** to **3**. Click **Next**.
4. **Step 3:** Under **Assignments**, assign to your devices using your custom groups, users, or devices. Click **Next**.
5. **Step 4:** Review, then click **+ Add**.

## Deploying Proximos Settings

1. After configuring all Proximos settings on a test admin Mac, In Proximos, go to **Settings → Export Settings Tab → Export as .plist…** and save `com.enlazo.proximos.settings.plist`.
2. In Intune, go to **Devices → macOS → Configuration → + Create → New policy**.
3. Set **Platform** to **macOS** and **Profile type** to **Templates → Preference File**. Click **Create**.
4. **Step 1:** Name the profile "Proximos Settings." Click **Next**.
5. **Step 2:** Set the **Preference domain name** to `com.enlazo.proximos.settings` with no ".plist" at the end. Under **Property list file**, select your exported `Proximos Settings.plist`. Click **Next**.
6. **Step 3:** Under **Assignments**, assign to your devices using your custom groups, users, or devices. Click **Next**.
7. **Step 4:** Review, then click **+ Add**.

## Deploying the Proximos PPPC Profile

Intune supports uploading custom configuration profiles directly, which is how the Full PPPC Profile is deployed.

1. In Proximos, go to **Settings → Extras → Proximos PPPC Profiles → Export Full Profile** and save `Proximos PPPC Profile.mobileconfig` — or retrieve it from the **Extras** folder inside [`Proximos.dmg`](https://files.enlazosystems.com/Proximos/Proximos.dmg).
2. In Intune, go to **Devices → macOS → Configuration → + Create → New policy**.
3. Set **Platform** to **macOS** and **Profile type** to **Templates → Custom**. Click **Create**.
4. **Step 1:** Name the profile "Proximos PPPC Profile." Click **Next**.
5. **Step 2:** Set the **Custom configuration profile name** to "Proximos Settings." Set the **Deployment channel** to **Device channel**. Under **Configuration profile file**, upload the `Proximos Full PPPC.mobileconfig` file from the **Extras** folder inside `Proximos.dmg`. Click **Next**.
6. **Step 3:** Under **Assignments**, assign to your devices using your custom groups, users, or devices. Click **Next**.
7. **Step 4:** Review, then click **+ Add**.

## Deploying the System or Headless Launch Agent

Intune only supports signed PKG files that contain a `.app`, so we cannot install Launch Agents via .pkg with Intune. Instead, a launch agent must be deployed as a shell script rather than a package.

1. Retrieve either the `Proximos System (Or Headless) Launch Agent.sh`   file from **Extras → Proximos MDM Scripts → Deployment Scripts** inside [`Proximos.dmg`](https://files.enlazosystems.com/Proximos/Proximos.dmg), or export your own from **Settings → Extras** in the Proximos app.
2. In Intune, go to **Devices → macOS → Scripts → Add**.
3. **Step 1:** Name the script "Proximos Launch Agent."
4. **Step 2:** Upload either the **Proximos System** or **Proximos Headless Launch Agent.sh** script. Set **Run script as signed-in user** to **No**. Set the **Script frequency** to **Every 1 day**. Click **Next**.
5. **Step 3:** Under **Assignments**, assign to your devices using your custom groups, users, or devices. Click **Next**.
6. **Step 4:** Review, then click **+ Add**.

Note: The launch agent deployment scripting automatically detect Proximos' .app location on the Mac endpoint, and creates the Launch Agent for that location.

See [About the System Launch Agent](/proximos/mdm-deployment#about-the-system-launch-agent-and-system-headless-launch-agent) for guidance on choosing between the standard and headless variants.