This instruction manual will guide you through the installation process of the macOS Footprint Agent.

Table of contents

General Prerequisites

• Minimum OS: macOS 10.15 (Catalina) or newer

• Disk Space Required: 200 MB

Installing the agent

From the Footprint console, go to SCAN SURFACE in the main menu:

Once here, go to the AGENT-BASED SURFACE menu option, then go to the SETUP AGENTS submenu :

Once here, you will then be presented with a brief overview of what an agent is

To install the agent, click on the GET button under the macOS icon. This will prompt the display of the installation script and the following relevant information:

• 🌐 Footprint Management URL: This is the URL of your Footprint instance

• 🔑 Footprint Agent Token: This is the token you will use to authorize the agent on your instance.

You can copy and paste the script into your terminal for a clean and silent install, or you can tailor it to fit your installation needs. The following parameters are permitted:

Examples:

# Standard install 
curl -L -o footprint-agent-installer.sh https://dev.codacloud.net/agent/macos/update/agent_installer.sh && sudo bash footprint-agent-installer.sh --token 4cc706dfanehmlml1pa5a2n0 --server_url https://url.com

# Custom install with provided path to package
sudo bash footprint-agent-installer.sh --token 4cc706dfanehmlml1pa5a2n0 --server_url https://url.com --pkg /path/to/pkg/FootprintAgent.pkg