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

# Install and Activate the Warmr Mac App on Your Machine

> Check the Mac and device requirements, install the Warmr Mac app, activate your license key, and prepare your Mac to control multiple iPhones.

Warmr runs on your Mac and drives your iPhones over USB. This page covers what you need, how to install the app, and how to handle the macOS security prompt on first launch.

## Mac requirements

Warmr is a **Mac-only** app. There is no Windows version.

* **Apple Silicon**: M1, M2, M3, or M4. **Intel Macs are not supported.**
* **macOS 14 or later.**
* On-device screen recognition runs on the Apple Silicon Neural Engine, which keeps sessions fast even across many iPhones at once.

### How many iPhones a Mac can drive

Each iPhone runs up to \~8 accounts. Use this as a starting point and size up for more devices:

| iPhones      | RAM                              | Storage  |
| ------------ | -------------------------------- | -------- |
| 1–3          | 16 GB                            | SATA SSD |
| 5            | 24 GB                            | NVMe SSD |
| 10           | 32 GB                            | NVMe SSD |
| More than 10 | [Talk to us](mailto:hi@warmr.so) | NVMe SSD |

From around 6 iPhones, connect them through a **powered** USB hub so devices don't drop off the bus under load.

### Also needed

* **Xcode** (Mac, free from the Mac App Store), to install the Warmr runner with a free Apple ID. Open it once after installing so it finishes first-launch setup.
* **An Apple ID**: a free one works; a paid Apple Developer account (\$99/year) makes runner installs one-button and removes weekly re-signing.
* **Physical iPhones you own**: Warmr drives real devices; emulators, cloud phones, and virtual machines are not supported. See [Connect iPhones](/setup/iphones) for supported models.

<Tip>
  Prefer to let an AI agent do the technical parts? Warmr ships an agent skill for Claude Code: copy one prompt and it installs the runner and drives setup for you, telling you the few taps only you can do. See [Set up with Claude](/set-up-with-claude).
</Tip>

## Installing the app

<Steps>
  <Step title="Download the installer">
    Sign in to your dashboard at [app.warmr.so](https://app.warmr.so) and download the Warmr Mac installer. The download link appears on your dashboard immediately after signup.
  </Step>

  <Step title="Open the .dmg and drag Warmr to Applications">
    Double-click the downloaded `.dmg` file to mount it. In the window that opens, drag the **Warmr** icon into the **Applications** folder shortcut. Wait for the copy to finish before ejecting the disk image.
  </Step>

  <Step title="Launch Warmr from Applications">
    Open **Finder**, navigate to **Applications**, and double-click **Warmr** to launch it.
  </Step>

  <Step title="Handle the macOS security warning (if it appears)">
    Because Warmr is distributed outside the Mac App Store, macOS may block it on the first launch. If you see a security warning, open **System Settings → Privacy & Security**, scroll down to the blocked app notice, and click **Open Anyway**. Confirm in the dialog that follows. You only need to do this once.
  </Step>

  <Step title="Activate your license key">
    When Warmr opens, it prompts you for your license key. Paste the key from your signup email or copy it directly from your dashboard at [app.warmr.so](https://app.warmr.so), then click **Activate**. Warmr confirms activation and loads the main interface.
  </Step>
</Steps>

## Connecting iPhones

Once Warmr is running, you can connect one or more iPhones to your Mac:

1. Plug the iPhone into your Mac using a data USB cable.
2. Unlock the iPhone. When the **Trust This Computer?** prompt appears, tap **Trust**.
3. The iPhone appears in Warmr's device list within a few seconds.

Repeat these steps for each additional iPhone you want to add.

<Warning>
  Connecting an iPhone is not the last step. Before it can warm or post, each device needs its iOS settings configured and the **Warmr runner** installed. A freshly connected phone with no runner won't do anything yet.
</Warning>

## Next: get each iPhone ready

Work through these in order for every iPhone:

<Steps>
  <Step title="Connect the iPhone">
    USB, unlock, **Trust**: covered above. More detail: [Connect iPhones](/setup/iphones).
  </Step>

  <Step title="Prepare the iOS settings">
    Developer Mode on, Appearance Light, StandBy off, Auto-Lock never, and a few more. [Prepare each iPhone](/setup/iphone-settings).
  </Step>

  <Step title="Install the Warmr runner">
    Install it once per device so your Mac can drive it. [Install the runner](/setup/install-runner).
  </Step>
</Steps>

<Note>
  Warmr needs to stay running on your Mac for warmups and auto-posts to work. Keep the Mac awake and plugged in during runs.
</Note>

<Tip>
  A powered USB hub lets you connect many iPhones to a single Mac and keeps connections stable under load. Use one for 4 or more devices.
</Tip>