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

# Install the Mac app

> Download Lusor for Mac, sign in, and keep the app up to date.

The Lusor Mac app connects your own iPhone to Lusor and runs the same app you use at [app.lusor.ai](https://app.lusor.ai). You need it only to use your own iPhone. Lusor Phones work from app.lusor.ai in your browser.

## Requirements

* A Mac with Apple silicon. The Mac app does not run on Intel Macs.
* A Lusor account. You can create one while you set up the app.
* To connect an iPhone, you also need full Xcode and a few other things. See [Connect your iPhone](https://docs.lusor.ai/help/connect-your-iphone.md#requirements).

## Install

**1. Download the app**

Download [Lusor for Mac](https://releases.lusor.ai/mac/Lusor-latest.dmg). The same link is in the app under **Add phone** → **Personal iPhone**, labelled **Download Lusor for Mac**.

**2. Move it to Applications**

Open the downloaded file and drag **Lusor** into your **Applications** folder.

**3. Open Lusor and sign in**

Open Lusor from Applications. On **Sign in to Lusor**, choose **Continue in browser**. Your browser opens so you can sign in or create an account. The Mac app moves on by itself when you are done.

**4. Choose where your iPhone goes**

If you belong to more than one organization, Lusor asks **Which organization?** It then asks **Which workspace?** Your iPhone joins that workspace when setup finishes.

To continue with an iPhone, follow [Connect your iPhone](https://docs.lusor.ai/help/connect-your-iphone.md).

## The menu bar menu

Lusor puts an icon in the Mac menu bar. Its menu shows whether your iPhone is connected and has these items:

| Item | What it does |
| - | - |
| **Open Lusor** | Opens the app window. |
| **Find iPhones…** | Looks for iPhones connected to this Mac, so you can set up another one. |
| **Reconnect iPhone** | Tries to connect your iPhone again after it stopped or needs attention. |
| **Pause iPhone** | Stops agents from using the iPhone: **Pause for 1 hour**, **Pause until tomorrow** or **Pause until I resume**. |
| **Check for Updates…** | Checks for a new version of the app. |
| **Quit Lusor** | Quits the app. Agents cannot reach your iPhone while Lusor is closed. |

## Account pages open in your browser

In the Mac app, **Members**, **Billing**, **Connectors** and **API Keys** open in your browser on app.lusor.ai instead of inside the app. These items are marked **Open Lusor Web**.

## Updates

Lusor checks for updates when it starts and every few hours after that. When an update is ready, you get a notification, and the menu bar item changes to **Install Lusor *version* and Restart…**. The update installs only when you choose that item, because restarting stops any agent run on your iPhone.


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