---
title: MDM
sidebar:
  label: Overview
description: Roll the scanner out to every endpoint through your device-management tool. Nobody has to sign in.
---

With MDM, each endpoint enrolls on its own. You create one **enrollment token** in the console, give it to your MDM, and deploy the package to the same endpoints. Each endpoint uses the token once, then gets its own permanent credential.

## Before you begin

- You have the **Owner** or **Admin** role in Surface, to create the enrollment token.
- You can add scripts, profiles, or packages to your MDM and assign them to a device group.
- The endpoints meet the [requirements](/surface/deploy/requirements).

## What the MDM delivers

| Setting | Required | What it does |
| --- | --- | --- |
| Enrollment token | Yes | Lets the endpoint join your organization |
| User email | No | Shows the person's email next to the hostname in the console. Never creates an account |
| User full name | No | Shown in the console |

There is no server setting. The installer already points at SuperAlign.

## The two ways to deliver the token

**Pre-filled install script.** On the console's **Downloads** page, download `install.sh` or `install.ps1`. The token is already inside. Upload it to your MDM's script library and run it as root (macOS, Linux) or SYSTEM (Windows). Simplest, and enough for most fleets.

**Managed configuration.** Push the token as a setting your MDM writes to the endpoint, and deploy the plain package separately. The setting survives reinstalls. The per-platform pages below show the exact keys.

You can combine both. Ordering does not matter: if the package lands before the token, enrollment retries on the next scan.

1. **Create an enrollment token**

    In the console, open **Downloads** and stay on **Silent install**. If no token is active, click **New token**, give it a name and an expiry, and click **Create Token**. See [Enrollment tokens](/surface/settings/enrollment-tokens).

2. **Configure your platform**

    <CardGroup cols={3}>
      <Card title="macOS" href="/surface/deploy/silent-install/mdm/macos" icon="apple">
        Jamf, Kandji, Mosyle, Intune. Configuration profile keys.
      </Card>
      <Card title="Windows" href="/surface/deploy/silent-install/mdm/windows" icon="monitor">
        Intune and Group Policy. Registry keys.
      </Card>
      <Card title="Linux" href="/surface/deploy/silent-install/mdm/linux" icon="terminal">
        A managed file. Debian and RPM packages.
      </Card>
    </CardGroup>

3. **Deploy the package**

    Assign the package or the pre-filled script to the same endpoints.

4. **Verify**

    Endpoints appear on **Endpoints** within one scan interval, with the user email you supplied. On an endpoint, `sudo surface status` shows the organization name.

## Also deploy the browser extension

If you plan to record sessions from AI websites, force-install the Surface Chrome extension alongside the scanner. See [Browser extension](/surface/deploy/silent-install/mdm/browser-extension).

## Next steps

- [Users](/surface/environment/users): roles belong to people. The user email you supply links each endpoint to its person, and a Member sees only their own endpoints
- [Update and uninstall](/surface/scanner/update-and-uninstall): upgrades through the same policy
