Installation on macOS Endpoints
Before You Begin
First, make sure that the endpoints you plan to manage with Action1 meet the requirements listed in this section.
The agent is always installed under the administrative account (root). It resides in /usr/local/action1 directory and operates as a daemon.
The next sections explain how you can install Action1 agent on a local or remote machine.
Step 1. Download the Action1 Agent Installer
- In Action1 console, click Install Agents in the top-right corner to open the Getting started wizard.
- On the Install Agent step, either click Download .SH to run the installer locally, or click Other Options if you plan to install the agent on another machine or run an unattended installation.
Step 2. Install the Agents
Use one of the following scenarios:
- Interactive installation
- Unattended installation
- Direct download for deployment using MDM tools
NOTE: No Action1 login is required to run the agent installation.
Scenario 1: Interactive installation
This option is recommended for first-time users.
- In the Getting Started wizard, click Download.SH to obtain the script for automated agent installation.
- On the local macOS machine, run the Terminal app as root.
- Locate the downloaded script named action1_agent_YourOrganizationName.sh.
- Copy the script name with the extension.
- Go to the Terminal window and run the following command, providing the script name: bash {script_name}
The script will automatically download and start the Action1 agent setup. Follow the Agent setup wizard as described below.
Agent Setup Wizard
- Accept the EULA.
- When prompted for destination and type, select Install for all users of this computer.
- Don’t change the installation destination – it must be /usr/local/action1.
- Enter the administrative account to install the software.
- Wait for the installation to complete. Then you can remove the PKG file.
Scenario 2: Unattended installation
This option is recommended for advanced users who want to install the Action1 agent on a local or remote endpoint in unattended (silent) mode.
- In the Getting Started wizard, click Other Options.
- Copy the corresponding script and run it on your target endpoints as root.
The following line will be copied:p=(pwd) && curl -o "{p}/action1_agent(My_Organization).pkg" "https://app.action1.com/agent/<id>/Mac/agent(My_Organization).pkg " && sudo installer -pkg "${p}/action1_agent(My_Organization).pkg" -target /
Here:
curl – cURL (Client for URL) utility for the file download.
-o – a parameter that instructs cURL to save the downloaded PKG file with the same name as in the URL.
id – a unique ID associated with a downloadable agent setup for your organization.
- Share the copied line with endpoint owners.
- Instruct them to launch the shell script using the Terminal window. The script will automatically download the PKG file and start the Action1 agent setup.
IMPORTANT! Note that the command uses $(pwd), that is, the current working directory. Instruct the endpoint owners to make sure they have sufficient directory permissions (write, execute) before proceeding with this command.
- Apply additional configuration after installation on the Apple Silicon devices to enable OS patching.
IMPORTANT! Action1 agent account requires elevated privileges. Since unattended mode is not allowed to display any user prompts, running it with non-elevated privileges will fail without any notifications. Make sure the root account is used to install the agent.
Scenario 3: Direct download for deployment tools
This option is recommended to those who need to download the agent installer (.PKG file) for use with MDM tools.
Copy the corresponding URL and use it with your deployment tool:
https://app.action1.com/agent/<id>/Mac/agent(My_Organization).pkg
Here id – a unique ID associated with a downloadable agent setup for your organization.