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

# Pair with your phone

> Pair the Enconvo iPhone or Android app with a Mac, a Windows PC, a Linux desktop, or a Linux server with only a terminal.

The Enconvo app on your phone pairs with each of your computers, so their projects and chats are on the phone. A chat you open from the phone keeps running on that computer, with its files, apps and agents. The phone reaches the computer through the Enconvo relay, and messages are end-to-end encrypted.

Each computer pairs with the phone on its own. Pairing two computers with each other (for example a Linux laptop with your Mac) doesn't add either one to the phone: pair the phone with each computer you want to use from it.

## Before you start

* **Get the app.** iPhone: [TestFlight](https://testflight.apple.com/join/MJQuEN28). Android: Google Play, or the APK. **Settings → Connections** on your computer has a download code for each.
* **Use one account.** Sign the phone app and the computer in to the same Enconvo account. Only phones on your account can pair.
* **Keep the computer on and Enconvo running.** The phone reaches a computer only while Enconvo runs there.

## Mac, Windows, or a Linux desktop

The steps are the same on all three.

**1. Show the pairing code on the computer**

Click the device switcher at the bottom of the sidebar, then **Add a device → Pair a phone**. Or open **Settings → Connections** and select **Show pairing code**. A QR code appears. It works once and lasts five minutes.

**2. Scan it with the phone**

In the Enconvo app, open **Remote**, tap **Pair a Mac**, and point the camera at the code. You can also scan it with the phone's own camera app: the code opens Enconvo, and you confirm there.

**3. Use the computer from the phone**

The phone pairs in a moment and shows the computer. With more than one computer paired, switch between them from **Remote**.

If the code expires, select **Show a new code** and scan again.

## A Linux server with only a terminal

A server has no window to show the code, so the command line prints it. This needs Enconvo 2.5.15 Beta 1 or later. Follow [Install on a server](https://docs.enconvo.ai/getting-started/linux.md#install-on-a-server) first.

**1. Sign the server in**

```bash theme={null}
enconvo login
```

Approve the code it prints at `enconvo.com/device`.

**2. Keep Enconvo running**

```bash theme={null}
enconvo service install
```

The phone reaches the server only while Enconvo runs there.

**3. Print the pairing code**

```bash theme={null}
enconvo companion pair --phone
```

It draws a QR code in the terminal, with a link under it, and says when it expires. The code works once and lasts five minutes.

**4. Scan it or open the link**

Scan the code with the phone's camera, or open the link on the phone. Confirm in the Enconvo app, and the server shows up on the phone.

* **Over SSH**: the code is drawn in your own terminal, so it works over SSH too. If it wraps, widen the window or open the link instead.
* **Sign-in**: typed in your own terminal, the code also signs the phone app in, so send it only to your own phone. Piped or saved output, or a command an agent runs, prints only the link, which doesn't sign the app in: sign the app in to the same account first.
* **Expired**: run `enconvo companion pair --phone` again.

## Manage paired phones

**Settings → Connections** on each computer lists its paired phones.

| To | Do this |
| - | - |
| Pair another phone | Show a new code and scan it with that phone. A computer can have up to 10 paired phones. |
| Remove a phone | Select **Remove** next to it. That phone can no longer reach this computer. |
| Start over | Select **Reset connection**. Every phone is removed and has to pair again. |

## Troubleshooting

| Problem | Fix |
| - | - |
| A computer isn't on the phone | Pair the phone with that computer itself. Pairing it with another computer doesn't add it. |
| **This code expired** | Show a new code, or run the command again, and scan within five minutes. |
| **Sign in to pair a phone** | Sign the computer in to Enconvo. On a server, run `enconvo login`. |
| The server says it isn't signed in | Run `enconvo login`, then `enconvo companion pair --phone` again. |
| The phone shows the server as offline | Check that Enconvo runs there: `enconvo service install`, and `sudo loginctl enable-linger "$USER"` if it stops when you log out. |

## Next steps

* [iPhone App](https://docs.enconvo.ai/integrations/iphone-app.md): what you can do from your phone, with a video tutorial.
* [Linux (Beta)](https://docs.enconvo.ai/getting-started/linux.md): install Enconvo on a desktop or a server.
* [Computers and SSH hosts](https://docs.enconvo.ai/integrations/computers-and-ssh-hosts.md): pair your computers with each other.


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