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

# Install on a Mac

> Install Quint on one Apple Silicon Mac, through your MDM or with a one-time install code, and confirm it reports in the dashboard.

This page is for one Mac: a pilot machine, or a machine you want to watch before the fleet. On a Mac, Quint is two profiles and one installer. Your MDM pushes the profiles first, then the installer. For a whole fleet, see [Roll out with MDM](https://docs.quintai.dev/install/mdm.md).

## Before you start

* An Apple Silicon Mac on macOS 14 or later, with an administrator account.
* The **Admin** or **Owner** role in the dashboard, to use [Add machines](https://docs.quintai.dev/install/add-machines.md).
* Read [What Quint records](https://docs.quintai.dev/get-started/what-quint-records.md). The installer shows the same notice before it installs anything.

## Install through your MDM

**1. Make a package**

Open **Add machines**. Choose **Mac**, then **A device management tool (MDM)**, then your MDM, and name the package, for example "Pilot Mac". Click **Make my files** and download the files: the approvals profile, the enrollment profile and the Mac installer.

**2. Assign both profiles to the Mac**

In your MDM, upload `quint-approvals.mobileconfig` and the `quint-enrollment-….mobileconfig` file, and scope both to this one Mac. Confirm they landed: **System Settings › General › Device Management** (on macOS 14, **Privacy & Security › Profiles**) lists "Quint approvals" and a "Quint enrollment" profile.

**3. Assign the installer**

Only then scope the installer package to the same Mac (on Intune, the **macOS app (PKG)** type; see [Microsoft Intune](https://docs.quintai.dev/install/mdm-intune.md)). The installer places **QuintAgent.app**, which carries the two system extensions, and the background service. With the profiles in place, both extensions activate without a prompt and the Mac joins your organisation.

**4. Confirm it reports**

The wizard's **First computer** step shows the Mac's checks as it reports in. In **Data Sources**, the Mac appears under **Telemetry by host** with its **Capture layers** and **Last seen**. Open the row: **Agents on this host** lists each coding agent found on the Mac and whether it is covered.

> [!NOTE]
>
> On Quint 1.1.29, a Mac that gets the installer before its enrollment profile does not start Quint. Install the package on that Mac again once the profile is there.

## If the Mac is not in an MDM

Open **Add machines**, choose **Mac**, then **Just one computer**. Name it, click **Get a one-time install code**, and paste the command it shows into Terminal on the Mac; paste the code when the command asks for your Quint token. The code adds one computer and stops working after 24 hours. See [One computer](https://docs.quintai.dev/install/add-machines.md#one-computer).

Without the approvals profile, macOS asks the person at the Mac to allow the extensions. Open **System Settings › General › Login Items & Extensions** (on macOS 14, **Privacy & Security**) and allow both Quint extensions. Then open **System Settings › Privacy & Security › Full Disk Access** and turn it on for the Quint endpoint extension; without it, macOS does not let the extension record file activity.

## If this fails

| What you see | What it means | What to do |
| - | - | - |
| The Mac does not appear in **Data Sources** after a few minutes | The installer landed before the enrollment profile, or the Mac has no outbound HTTPS | Check both profiles are listed under **System Settings › General › Device Management** (on macOS 14, **Privacy & Security › Profiles**), and the network. If the installer came first, install it again. |
| macOS shows a prompt to allow a system extension | The approvals profile did not land first | Allow both extensions in **System Settings › General › Login Items & Extensions** (on macOS 14, **Privacy & Security**). |
| The host shows **Degraded** under **Data Sources** | Not every capture layer is live, usually Full Disk Access | Grant Full Disk Access to the Quint endpoint extension, or check the approvals profile. |
| An agent on the Mac is missing from **Agents on this host** | The endpoint has not wired that agent yet, or has no adapter for it | Wait for the next check-in. If it stays missing, see [Supported agents](https://docs.quintai.dev/install/supported-agents.md) and [Verify a machine](https://docs.quintai.dev/install/verify-and-troubleshoot.md). |

## Next

* [Verify a machine](https://docs.quintai.dev/install/verify-and-troubleshoot.md)
* [Roll out with MDM](https://docs.quintai.dev/install/mdm.md)


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