Manual Installation
This document explains the process of installing the Nightfall agent manually.
Prerequisites
Ensure that you have root level access to the target macOS device.
On your Nightfall console, navigate to https://app.nightfall.ai/endpoint and click the Download Package button on the top right corner of the page. Click Download Package for macOS and unpack the contents of the downloaded file.
Create a default policy for web browser uploads and cloud storage application sync.
Installing the Package
Locate the
mdm_pre_installation_script.sh
in the payload downloaded from Nightfall.Open a Terminal window.
Run the
mdm_pre_installation_script.sh
script on your local machine as a root user, by executing the following command.
sudo ./mdm_pre_installation_script.sh
Double click the provided
nightfall-ai-agent_<version>.pkg
.Click Continue.


Click Install.

Click Use Password to enter your device password and start the installation process.

Once the installation is completed, you get a completion message as shown in the following image.
Click Close.

At the top right corner of your screen, you can view the Nightfall AI agent icon which looks as follows.

When you click this icon, you can view the details of the agent.

Grant System Permissions
These system permissions and handled automatically through MDM profiles. For manual install, enabling these permissions manually is required.
Grant Full Disk Access
To monitor your MAC device, you must grant access to the hard disk. This section explains the process of granting disk access.
Navigate to System Settings > Privacy & Security > Full Disk Access.

If Nightfall is listed, make sure to toggle the permission to ON
[Optional] Should Nightfall not be listed in the primary list
Click the + icon at the bottom of the list (you may be prompted to enter your macOS password)

Select NightfallAIAgent (under Applications) and click Open.

Click Quit & Reopen.

On the Full Disk Access page, ensure that the toggle switch is turned on for the NightfallAIAgent. This ensures that the full disk access is granted.

Grant Accessibility Permissions
For clipboard monitoring, you must grant the Nightfall agent accessibility permissions. This section explains the process.
Navigate to System Settings > Privacy & Security > Accessibility.

If Nightfall is listed, make sure to toggle the permission to ON

[Optional] Should Nightfall not be listed in the primary list
Click the + icon at the bottom of the list (you may be prompted to enter your macOS password)

Select NightfallAIAgent (under Applications) and click Open.

On the Accessibility settings page, ensure that the toggle switch is turned on for the NightfallAIAgent. This ensures that the full disk access is granted.

Reboot The Agent
To ensure changes are picked up by the agent:
Open Activity Monitor > Search of Nightfall > you should see two Nightfall processes running
If you do not see two Nightfall processes, make sure to expand your view to all processes
Select both process and click Quit, the agent will restart instantly.

Grant Browser Permissions
Apart from the disk access and accessibility permissions, you must also grant permission to the Nightfall AI agent to monitor browser uploads. This section explains the process.
To grant access to browser uploads:
Open a browser instance and upload a test file to any destination.
When prompted, grant the Nightfall AI agent permissions.
At this stage, your manual installation is complete. You machines should start showing up on you Nightfall AI managemetn console under https://app.nightfall.ai/endpoint
Uninstalling the Nightfall AI Agent
To uninstall the Nightfall AI agent, locate the uninstallation script provided as part of the deployment bundle. You must execute the following command on your MAC device, as a root user.
mdm_nightfall_ai_agent_uninstall.sh
Last updated
Was this helpful?