> ## Documentation Index
> Fetch the complete documentation index at: https://support.telivy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Install the Telivy Agent on macOS

> Deploy the Telivy agent to Macs with an RMM or MDM command or the .dmg installer, grant Full Disk Access and Keychain access, or run the agentless scanner.

macOS support is in beta. The agent runs on Apple Silicon and Intel Macs with macOS 13 Ventura
or later, and installing it needs an administrator password. The instructions are on the
assessment's **Setup** tab under **Deploy Agent > Instructions**. Select **macOS** in the
operating system switch, then **Agent** or **Agentless**.

Not sure which mode to use? See [Agent vs Agentless](https://support.telivy.com/products/risk-assessments/agent-vs-agentless.md).

> [!WARNING]
>
> Allow Telivy in the client's antivirus or EDR before you deploy: the app
> `/Applications/Telivy.Scanner.Mac.app` and the `*.telivy.com` domains. See
> [Allow Telivy in AV and EDR](https://support.telivy.com/products/risk-assessments/whitelist-telivy-with-av-edr.md).

## Install the agent

> [tab] With an RMM or MDM
>
> Each assessment has its own install command. Under **Instructions for RMM**, select **Copy** next to the install command and run it as root from any RMM or MDM that can run a shell script,
> or in Terminal on the Mac:
>
> ```bash theme={null}
> sudo /bin/bash -c "curl -fsSL 'https://install.telivy.com/Installer/install-macos.sh' | bash -s -- -s <DEEP_SCAN_ID> scan"
> ```
>
> The copied command already contains the assessment's ID. The script detects whether the
> Mac has Apple Silicon or an Intel chip and installs the matching package.
>
> Tools that already run scripts as root, such as Jamf Pro, Kandji, Mosyle, Microsoft Intune,
> and NinjaOne, do not need the `sudo` prefix. Leaving it in is harmless.
>
> | Tool | Where to add the script |
> | - | - |
> | Jamf Pro | **Settings > Computer management > Scripts**, then a **Policy** that runs the script on the Macs |
> | Kandji | **Library > Custom Script**, assigned to the Macs' Blueprint |
> | Mosyle | **Management > Custom Commands**, assigned to the Macs |
> | Microsoft Intune | **Devices > Scripts and remediations > Platform scripts**, a macOS shell script run as root (**Run script as signed-in user** set to **No**) |
> | NinjaOne | **Administration > Library > Automation**, a new Shell script for macOS run as System |
>
> > [!WARNING]
> >
> > The command cannot grant Full Disk Access or Keychain access. After it runs, the person
> > using each Mac still has to approve both, as described in
> > [Grant the permissions the agent needs](#grant-the-permissions-the-agent-needs).
>
> ![Install Telivy Agent for MacOS card with .dmg installer downloads for Apple Silicon and Intel, instructions for employees and the RMM install command with its Copy button](https://mintcdn.com/telivy-0f6c7022/2gk8GzJRpZKyB-yB/images/install-telivy-agent-macos/install-telivy-agent-macos-1.png?fit=max\&auto=format\&n=2gk8GzJRpZKyB-yB\&q=85\&s=7b4b251d387f45bfcca2a626e313d4fc)

> [tab] With the installer
>
> Select **Download Telivy Agent Installer (.dmg)** for **Apple Silicon** or **Intel**, or
> **Copy Link \[Apple Silicon]** or **Copy Link \[Intel]** and send the link to the employee. On the Mac:
>
> 1. Double-click the downloaded file to mount it.
> 2. In the window that opens, double-click **Telivy Agent One-Click Installer**.
> 3. Enter an administrator password when asked. The agent cannot be installed without it.
> 4. Wait for the confirmation that the agent is installed.

## Grant the permissions the agent needs

macOS asks each user to approve access to files and saved passwords. Without these two steps
the agent still runs, but PII and password results are incomplete. Ask the person using the Mac
to do both after the install.

**1. Turn on Full Disk Access for PII scanning**

Open **System Settings > Privacy & Security > Full Disk Access**, find **Telivy.Scanner** in
the list, and turn it on. macOS asks for the user's password to confirm.

**2. Allow Keychain access for password scanning**

In **Finder**, open the **Applications** folder and open **Telivy.Scanner.Mac**. It starts a
setup mode that asks for Keychain access once for each Chromium-based browser, such as
Chrome, Edge, or Opera. Enter the password and choose **Always Allow** each time.

## Agentless deployment

Use the agentless scanner when you cannot install software on the Mac, or when you want
employees to run a one-time scan themselves. Select **Agentless**, then **Download Telivy
Scanner (.dmg)** for **Apple Silicon** or **Intel**, or **Copy Link \[Apple Silicon]** or **Copy Link \[Intel]**. Send
employees these steps:

1. Download the version for the Mac's chip.
2. Double-click the file to mount it.
3. In the window that opens, double-click **Telivy Scanner One-Click Runner**.
4. Enter an administrator password when asked.

The scanner leaves nothing installed. To clean up, eject the disk image and delete the
downloaded file.

![Agentless Deployment card for macOS with Download Telivy Scanner (.dmg) and Copy Link buttons for Apple Silicon and Intel and the steps for employees](https://mintcdn.com/telivy-0f6c7022/2gk8GzJRpZKyB-yB/images/install-telivy-agent-macos/install-telivy-agent-macos-2.png?fit=max\&auto=format\&n=2gk8GzJRpZKyB-yB\&q=85\&s=6d5513538754fc1a43663cb1619e3163)

## What happens after install

The installer adds `Telivy.Scanner.Mac` to the **Applications** folder and a background service
that starts with the Mac. Like the Windows agent, it checks in once an hour and starts the
scanner, which only collects what is due. [Scanning Schedule](https://support.telivy.com/products/risk-monitoring/scanning-schedule.md)
lists how often each check runs. The Mac then appears under **Deploy Agent > Deployment
Status** and on **Inventory > Endpoints**.

Keep the agent current with [auto-update](https://support.telivy.com/products/risk-assessments/auto-update.md), which
supports macOS. To remove it, see [Uninstall on macOS](https://support.telivy.com/products/risk-assessments/uninstall-telivy-agent-macos.md).
If a Mac does not appear or its results are incomplete, see
[Troubleshoot the Telivy Agent](https://support.telivy.com/products/risk-assessments/troubleshoot-telivy-agent.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.