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

# macOS

> Install ZeroGPU Edge on Macs and managed Mac fleets.

ZeroGPU Edge runs on macOS as a system background service under its own restricted account. It starts at boot and serves inference while the Mac is available. See the [agent overview](https://docs.zerogpu.ai/edge/agent.md) for how fleets earn and for every setting.

> [!TIP]
>
> Building a macOS desktop app that should contribute while your users run it? Use the [macOS desktop app SDK](https://docs.zerogpu.ai/edge/sdk/electron.md) instead.

## Requirements

| Requirement | Value |
| - | - |
| **macOS** | macOS 14 Sonoma or later on Apple silicon; macOS 13.4 or later on Intel. The installer refuses older versions. |
| **Architecture** | Apple Silicon (arm64) or Intel (x86\_64) |
| **GPU** | Used automatically on Apple Silicon. Intel Macs are supported and get smaller models. |
| **Credentials** | Your fleet's SDK key (`zgpu-sdk-…`) from the [Edge Operator Portal](https://edge.zerogpu.ai) |
| **Install rights** | Administrator |

## Download

From [apps.zerogpu.ai/edge](https://apps.zerogpu.ai/edge?os=macos):

| File | Use it for |
| - | - |
| `ZeroGPU.dmg` | Installing on a single Mac, with a guided setup |
| `zerogpu-edge.pkg` | Silent and MDM installs (Jamf, Kandji, and other device-management tools) |

> [!NOTE]
>
> Both installers are signed with ZeroGPU's Apple Developer ID and notarized by Apple, so they open without a security prompt. To check a download, compare its hash with the `SHA256SUMS` file published alongside it:
>
> ```bash theme={null}
> shasum -a 256 ZeroGPU.dmg
> ```

## Install

> [tab] Guided (one Mac)
>
> 1. Open `ZeroGPU.dmg` and run **Install ZeroGPU Edge**.
> 2. Paste your SDK key and enter an administrator password.
>
> The service starts right away and again at every boot. **ZeroGPU Edge** is added to Applications and to the menu bar.

> [tab] Silent / MDM
>
> ```bash theme={null}
> sudo installer -pkg zerogpu-edge.pkg -target /
> sudo zerogpu-edge configure --operator-key "zgpu-sdk-your-key" --cust-param1 "site-a" --restart
> ```
>
> Through MDM, deploy `zerogpu-edge.pkg` together with a configuration profile that sets the operator key and pre-approves the background service, so users see no prompts. Contact [hello@zerogpu.ai](mailto:hello@zerogpu.ai) for the profile templates.

## Configure

The settings table is on the [agent overview](https://docs.zerogpu.ai/edge/agent.md#configuration).

```bash theme={null}
sudo zerogpu-edge configure --resource-policy idle-only --restart
```

## Verify

```bash theme={null}
zerogpu-edge status
```

The status shows the service registered and serving. You can also open the ZeroGPU Edge menu bar icon. Then confirm the Mac in the portal: [Verify devices](https://docs.zerogpu.ai/edge/verify.md).

## Uninstall

```bash theme={null}
sudo /Library/ZeroGPU/Edge/bin/uninstall.sh
```

## Troubleshooting

| Symptom | Fix |
| - | - |
| Service installed but waiting for a key | Run `sudo zerogpu-edge configure --operator-key … --restart`, or use **Change operator key…** in the menu bar app. |
| macOS asks to allow a background item | Allow **ZeroGPU Edge** under **System Settings → General → Login Items**. MDM deployments can pre-approve it. |
| Anything else | See [agent troubleshooting](https://docs.zerogpu.ai/edge/agent.md#troubleshooting). |


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