> ## 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.

# Connect your Android phone

> Set up your own Android phone with the Lusor Launcher app, step by step, so agents can use it.

When you finish these steps, your Android phone shows on the **Phones** page as your own phone, and agents in your workspace can use it.

Your phone connects through **Lusor Launcher**, a small app you install on the phone itself. On the phone it is called **Lusor**. You don't need a computer cable or a Mac. Agents see the screen and tap, type and swipe through the app's accessibility service. Setup takes about a minute.

## Requirements

* **An Android phone running Android 12 or later**, on Wi-Fi or mobile data.
* **A computer signed in to Lusor**, to approve the phone's sign-in code: [app.lusor.ai](https://app.lusor.ai) in a browser or the Lusor Mac app.
* **A free phone slot on your plan.** Your phone uses one slot. See [Plans and credits](https://docs.lusor.ai/help/plans-and-credits.md).

## Start in the Lusor app

1. In the [Lusor app](https://app.lusor.ai), open the **Phones** page and choose **Add phone**.
2. Choose **Personal Android**. Keep this window open: you enter the phone's code here in a moment.

## Install Lusor Launcher

1. On your Android phone, open **lusor.ai/android** in the browser. The Lusor Launcher app downloads.
2. Open the download. When Android asks, allow installing apps from this source, then tap **Install**.
3. Open the **Lusor** app you just installed.

Lusor Launcher keeps itself up to date. When a new version is ready, it shows an **Update available** notification. Tap it to install.

## Sign in

1. On the phone, tap **Sign in**. The phone shows an eight-character code.
2. On your computer, in **Add phone** → **Personal Android**, type the code under **Enter the code from Lusor Launcher** and choose **Confirm**. Your browser opens login.lusor.ai to confirm it.

   You can also enter the code with **Add phone** in the Lusor Mac app, or confirm it directly at **login.lusor.ai/device**.
3. Wait for the phone to show **Signed in**.

New to Lusor? Tap **New to Lusor? Create an account** on the phone instead, then create your account on the page where you enter the code.

## Add the phone to a workspace

1. On **Add this phone to a workspace**, pick the workspace the phone should join.
2. Check the **Phone name**. You can rename or remove the phone any time from **Phones** in Lusor.
3. Tap **Add phone**.

## Turn on Lusor agent

Agents use the **Lusor agent** accessibility service to see the screen and tap and type.

1. Tap **Open Lusor agent in Accessibility**.
2. Tap **Installed apps** → **Lusor agent**, turn it on, then tap **Allow**.

> [!NOTE]
>
> Android blocks this switch for apps installed from a browser. If Android says **Restricted setting**, tap **OK**. Then open **Settings** → **Apps** → **Lusor**, tap **⋮** at the top right and choose **Allow restricted settings**. Go back and turn on **Lusor agent** again. Lusor Launcher shows these steps when it needs them.

## Let Lusor run in the background

1. On **Let Lusor run in the background**, tap **Allow** when Android asks. Android pauses apps on an idle phone, and this keeps your phone reachable.
2. On Samsung, also add Lusor to **Never sleeping apps**. Lusor Launcher links to it.

## Allow Lusor over other apps

1. On **Allow Lusor over other apps**, tap **Open settings**.
2. Find **Lusor** in the list and switch it on. On Samsung this is called **Appear on top**.

Lusor Launcher comes back by itself once it's on, and the phone shows **Ready for agents**. It also appears on the **Phones** page in the Lusor app.

You can lock the phone and put it down. Keep **Lusor agent** on in Accessibility.

## Use the phone

* **Live view and recordings** work on your own Android phone. The live view pauses while the phone is locked and resumes when you unlock it.
* **It does not use Lusor Phone minutes.** Agent time on your own phone uses credits for the AI work but no Lusor Phone minutes.
* **Internet and location settings do not apply.** Your phone uses its own connection. Those settings are for [Lusor Phones](https://docs.lusor.ai/help/lusor-phones.md).
* While an agent is working, the phone shows **Agent working**. Touching the screen can interrupt the agent, so watch it live in Lusor instead. To end the run from the phone, tap **Stop this run**.

## Full access (optional)

**Unlock full access** on the **Ready for agents** screen adds app installs and more device controls. It uses the phone's Wireless debugging, so it needs Developer options and Wi-Fi. Lusor Launcher walks you through three steps: turn on Developer options, turn on Wireless debugging, and pair with the six-digit code Android shows.

Lusor connects to Wireless debugging from inside the phone. It never asks you to plug into a computer. If Wi-Fi is off, agents keep using the phone through Lusor agent.

## Remove the phone

* In the Lusor app, open the phone menu on the **Phones** page and choose **Remove phone…**, then **Remove phone**. This frees its phone slot.
* Or, on the phone, tap **Remove this phone** in Lusor Launcher.

To use the phone again, open Lusor Launcher and add it to a workspace again.

## Troubleshooting

| What you see | What to do |
| - | - |
| **That code expired** or **Sign-in was declined** | Tap **Get a new code** and enter the new code on your computer. |
| **Lusor agent is off** | Turn **Lusor agent** back on in Accessibility. Agents can't use the phone until it is. |
| **This phone is disconnected** | Check the phone is online, then open Lusor Launcher. It reconnects by itself. |
| **This phone was removed from the workspace** | Add the phone to a workspace again from Lusor Launcher. |
| **Update Lusor to continue** | Install the update from the **Update available** notification, or download it again from lusor.ai/android. |
| The phone shows **Offline** on the **Phones** page | Open Lusor Launcher on the phone. It shows what it needs. |


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