Install Mac forwarder manually

With the Stairwell Forwarder for MacOS, organizations can automatically collect files from macOS devices (Intel & Apple Silicon supported) and have them processed by the Stairwell platform. To install the Stairwell Forwarder, multiple pieces will need to be in place before it can fully function.

🚧

This guide is strictly for manually installing the Stairwell Forwarder directly on a single device – usually for testing purposes.

This section should not be used to deploy the Stairwell Forwarder across your environment. For a specific, step-by-step guide using an MDM, please check to see if there is an article available here.

🚧

Warning!

The initial scan (we refer to as the backscan) is a comprehensive physical disk scan that is very resource intensive for a short period of time. We do not recommend installing the forwarder on critical assets early in your deployment. Think of your first several deployments as "sacrificial" in that they will take the biggest hit because they will be uploading the greatest number of unique files and each subsequent install will have less and less unique files and therefore, shorter and less intensive backscans.

Installation

• Download the installer (.pkg) file and the "Forwarder Settings" configuration file (Stairwell Forwarder Settings Template.mobileconfig) to your device.

📘

"System Extension Policy" and "Privacy Preferences" .mobileconfigs files are not needed for manual installation

• Open Stairwell Forwarder Settings Template.mobileconfig with a text editor and update Your_EnvId_Here with your Environment ID and Your_Registration_Token with your Authentication Token
• Save and close the .mobileconfig file
• Open System Preferences ➡️ Security ➡️ Profiles
• Click on the + button in the bottom left and select the .mobileconfig file. Select Continue and then Install on the following dialog boxes. This will install the Stairwell Forwarder Settings profile

• Open a Terminal prompt and navigate to the folder where you downloaded the .pkg file and execute the following command:

sudo installer -package StairwellForwarder.pkg -target /

• When the installer runs, you will receive a prompt. Click on the Open System Preferences button and then click Allow

• Enable full disk access by opening System Preferences ➡️ Security & Privacy ➡️ Privacy ➡️ Full Disk Access and then click the checkbox next to the Stairwell Forwarder.

The Stairwell Forwarder for macOS should now be installed on your device with the permissions required to allow ingestion.

Confirm Installation

• Navigate to https://app.stairwell.com and log in
• Click on Assets
• Click on the newly created asset name(s) to confirm the retrieval of files
• Take note of the data under All Objects

📘

It may take a few minutes for file ingestion to begin and show in the application.