Lumu Agent For macOS

Lumu Agent For macOS

The installation of the Lumu Agent is simple and straightforward. In this document, we guide you through the installation of the Lumu Agent for macOS via the application and using the terminal.

For getting started with agents, access Introduction to Lumu Agents.

Requirements

  1. A device running a macOS operating system.  Minimum supported version: v10.15 (Catalina)
  2. Administrator permissions on the local machine.
Before installing Lumu Agent, make sure you create a group  in the Lumu Portal. An internet connection is required for the Lumu Agent activation.

The Lumu Agent is a lightweight software program, below are some referential information regarding the agent average consumption on macOS devices:

RAM consumption (average): 25 MB
CPU consumption (average): < 2%
BW consumption  (average): 1 Kbps
Online installer size: 3.3 MB
Agent installed size: 10.6 MB

Agent Installation

1. To download the agent file for installation on macOS, go to the Lumu Portal  and navigate to the Agents menu, click to download, and select the macOS option.



2. Select the installer according to the architecture of the device.

Lumu provides two different installers for macOS, one for Intel processors (X86_64) and another one for M1 processors (ARM). Select the installer according to the devices’ architecture. For help identifying the type of processor on a macOS device, consult How to check if a macOS device is using an Intel or M1 processor?

3. Once downloaded, run the installation file. You will be guided through the steps to install the Lumu Agent. When requested, accept the license agreement, select the disk, and provide the device’s access credentials.


4. Once installed, locate and run the “Lumu Agent” application.

5. Once the Lumu Agent starts for the first time, you will be requested to enter the activation code from the group you created previously .


An internet connection is required for the Lumu Agent activation.
6. After activation, you will see the completion screen, click “Close”.

Installation via Terminal

You also have the option to install the Lumu Agent via the macOS command prompt. The installation command to deploy the Lumu Agent (.pkg) via terminal should look like this:
sudo installer -package path_to_package_file.pkg -target /

The next step is to activate the Lumu Agent using the installation path ( /Applications/Lumu Agent.app/Contents/MacOS/lumuagentctl ) and the activation code of the group . The command should look like this:

"/Applications/Lumu Agent.app/Contents/MacOS/lumuagentctl" activation_code [ActivationCode]


This Terminal Installation procedure is useful when utilizing IT Management Software for mass deployment of the Lumu Agent; however, there are scenarios where deployment on a device may fail despite using the appropriate installer for the device's processor architecture. This occurs on devices with M1 processors with Intel compatibility enabled. In these cases, the IT Management Software may force you to use the Intel installer to circumvent the issue and install the Lumu Agent. Beware that despite installing successfully the agent may run with limited functionalities on the device.           

Command Quick Reference for Agent Support

The Lumu Agent for macOS includes an application for support purposes. You can use this application to troubleshoot and get agent information from devices. You should run the commands in the Lumu installation path (i. e. /Applications/Lumu Agent.app/Contents/MacOS/lumuagentctl ) using admin privileges. To obtain the list of commands available, use the parameter -h, as in the following example.

"/Applications/Lumu Agent.app/Contents/MacOS/lumuagentctl" -h

Update Agent

The update process is already integrated with the agent application. Once a new version is available, the application will prompt the user to update.


You can also check for updates and see the agent version using the macOS settings option, as in the following image:


Uninstall Agent

To uninstall the Lumu Agent using a macOS device via terminal, go to the Lumu installation path ( /Applications/Lumu Agent.app/Contents/MacOS/lumuagentctl ) and run the parameter uninstall. This command requires administrator privileges. The command should look like this:

"/Applications/Lumu Agent.app/Contents/MacOS/lumuagentctl" uninstall

    Still can’t find an answer?
    Send a message to our experts.
    Contact Us

        • Related Articles

        • Lumu Agent Deployment Via ConnectWise Automate RMM

          The Lumu Agent can be deployed remotely in corporate environments using an array of tools such as Remote Monitoring and Management software (RMM). This article describes the remote installation procedure of the Lumu Agent for Windows [add link] and ...

        • Lumu Agent Deployment via NinjaOne RMM

          The Lumu Agent can be deployed remotely in corporate environments using an array of tools such as Remote Monitoring and Management software (RMM). This article describes the remote installation procedure of the Lumu Agent for Windows and macOS using ...

        • Lumu Agent Deployment via Kaseya VSA

          The Lumu Agent can be deployed remotely in corporate environments using an array of tools such as Remote Monitoring and Management software (RMM). This article describes the remote installation procedure of the Lumu Agent for Windows  and macOS   ...

        • Configure DNS in Apple macOS

          Setting up DNS forwarding on a macOS client device is the configuration suggested for testing purposes. We recommend you  configure your DNS server or your router to take the most advantage of Lumu Continuous Compromise Assessment on your entire ...

        • Lumu Agent Deployment via Microsoft Intune

          The Lumu Agent can be deployed remotely in corporate environments using various tools such as Remote Monitoring and Management software (RMM). This article describes Microsoft Intune. This is a two-step process: First, you must complete the steps in ...