# Nightfall macOS Agent Deployment: PDQ SimpleMDM

## **Pre-Requisites**

1. Enroll devices in PDQ SimpleMDM
2. Create a Device Group with the respective macOS machines assigned to it
3. Download and unpack Nightfall's install package from the console:
   * **Integrations** > **Manage** (Endpoint Windows) > **Download Package** > click "**Download Package**"

{% hint style="warning" %}
PDQ SimpleMDM does not have the ability to run a job to deploy in a specific order.  Due to this, follow the steps below explicitly so as to make sure the agent has the appropriate permissions during install.
{% endhint %}

## Step 1: **Deploy the Script**

1. From within SimpleMDM, navigate to Scripts > click “Scripts” > click “Create Script”
2. Name: Nightfall Pre-Installation Script
3. Click “Choose File”
   1. Select the “mdm\_pre\_installation\_script.sh” from the mdm\_scripts folder that was downloaded from the Nightfall Console.
4. Create a job.
   1. Navigate to Scripts > click “Job” > click “Create Job”
   2. **Name**: Deploy Nightfall Pre-Install Script
   3. **Script**: Select the “Nightfall Pre-Installation Script”
   4. **Run on**: Select the Group
   5. **Run Options**: Select “Run ASAP”
   6. Click “Create”

## **Step 2: Deploy the Profile**

1. Navigate to Configs > click “Profiles” > click “Create Profile”
2. Select “Custom Configuration Profile”
   1. **Name**: Nightfall Profile
   2. Uncheck “Install via Declarative Management”

      <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p>In testing there were issues with profile deployment unless this was unchecked.</p></div>
   3. **Mobileconfig**: Click “Choose File”
   4. From the mac\_bundle folder, navigate to “profiles” > select “NightfallAI\_Profile\_with\_Browser\_Extensions.mobileconfig”
   5. **OS**: Only select “macOS”
   6. Navigate to the “Groups” tab
   7. Click “Assign Group”
   8. Select the group > click “Assign”
3. Navigate back to “Profile” tab > click “Save”

## Step 3: Deploy the Agent

1. Navigate to Apps & Media > click “Catalog” > click “Add App” > select “Custom App”
2. From the mac\_bundle folder, locate the “nightfall-ai-agent-signed.pkg” > click “Open”
3. Click the “Groups” tab > click “Assign Groups”
   * **Install Method**: MDM
   * **Install Type**: Auto
   * **Groups**: (select group)
4. Click “Assign”
5. Click “Done”


---

# 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://help.nightfall.ai/data-exfiltration-prevention/exfiltration_endpoint/installation_mac/nightfall-macos-agent-deployment-pdq-simplemdm.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.