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

# Quick Start

> Create an enrollment key, install the agent on your Mac, and view your first scan results

This guide walks you through creating an enrollment key, installing the Golf Inventory agent on a Mac, and viewing your first scan results in the dashboard.

## What You'll Learn

* How to create an enrollment key
* How to install Golf Inventory on a Mac
* How to verify enrollment and view scan results

## Prerequisites

* Golf Control Plane account with admin access
* macOS device (Apple Silicon or Intel)
* Root/sudo access on the target machine

<Steps>
  <Step title="Create an Enrollment Key">
    Navigate to **Inventory > Enrollments** in the Golf Control Plane and click **New enrollment**.

    Configure your key:

    * **Name**: A descriptive label (e.g., "Engineering team")
    * **Max enrollments**: Maximum number of devices that can use this key (default: 100)
    * **Expiry**: Number of days until the key expires (default: 90)

    Click **Save**. Copy the enrollment key (`sk_enroll_...`) immediately.

    <Warning>
      Save the enrollment key immediately. It is shown once and cannot be retrieved later — it is stored as a PBKDF2 hash.
    </Warning>

    **Checkpoint**: You have an enrollment key starting with `sk_enroll_`.
  </Step>

  <Step title="Install the Agent">
    Download the install script from the credentials modal on the Enrollments tab, or run:

    ```bash theme={null}
    sudo ./install.sh <enrollment-key> <api-url>
    ```

    The script:

    1. Downloads the latest `scanner-mcp` binary for your architecture
    2. Verifies the SHA-256 checksum
    3. Installs to `/Library/GolfGateway/scanner-mcp/bin/`
    4. Enrolls the machine with the platform
    5. Creates a LaunchDaemon that scans every 15 minutes

    **Checkpoint**: You see "Enrollment successful" in the terminal.
  </Step>

  <Step title="Verify Enrollment">
    Go to **Inventory > Devices** in the Golf Control Plane.

    Your machine should appear with status **Active**, showing its hostname and operating system.

    **Checkpoint**: Your machine appears in the Devices list.
  </Step>

  <Step title="View Scan Results">
    Go to **Inventory > Overview** to see the executive dashboard with discovered servers, risk scores, and governance classification.

    Then go to **Inventory > Servers** to see individual servers with their audit results, risk scores, and finding details.

    <Note>
      Some checks (sandbox analysis, capability analysis) run asynchronously. You may see "Pending" scores that resolve within a few minutes. The dashboard polls every 10 seconds while scores are pending.
    </Note>

    **Checkpoint**: You see MCP servers from your machine in the Servers tab.
  </Step>
</Steps>
