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

# Choose your xpander and sign in

> On first launch, enter the address of your xpander (xpander cloud or your company's own), then sign in through your browser with the account you already use on the web.

## Choose your xpander

On first launch the app asks which xpander you use. Enter its address and choose **Continue**:

* **xpander cloud**: `chat.xpander.ai`.
* **A self-hosted xpander** (Hybrid or Air-gapped): your company's own address, for example `chat.acme.com`. Ask your admin if you do not know it.

![Welcome to Omni screen with an xpander URL field and a Continue button](https://mintcdn.com/xpanderai-099931d1/5kO48nCPjVxjKi_K/images/desktop/first-run.png?fit=max\&auto=format\&n=5kO48nCPjVxjKi_K\&q=85\&s=1a0ffdeafa0eeb3f167b58b35bf824c5)

First run: the address of your xpander. Shown with sample data.

If your company manages your Mac, the address may already be filled in and read **Set by your organization**; you cannot change it. See [MDM](https://docs.xpander.ai/desktop/self-hosted.md#point-every-mac-at-your-xpander-with-mdm).

![First run screen with the address field locked and the note Set by your organization](https://mintcdn.com/xpanderai-099931d1/5kO48nCPjVxjKi_K/images/desktop/first-run-locked.png?fit=max\&auto=format\&n=5kO48nCPjVxjKi_K\&q=85\&s=ed709548cd1c1f5e694bdaf10178befc)

An address set by your organization. Shown with sample data.

If the app cannot reach the address, it says **Could not reach** with the address. Check the spelling and your network (and VPN, for a self-hosted xpander), then choose **Try again**.

To use a different xpander later, change the address in [Settings](https://docs.xpander.ai/desktop/settings.md). Changing it signs you out first.

## Sign in through your browser

The app has no sign-in form of its own. You sign in in your browser, the way you always do on the web (single sign-on, Google, GitHub or email), and the browser hands the app its own session for this Mac.

1. In the app, choose **Sign in with your browser**. The dialog shows which xpander you are signing in to; **Change** goes back to the address.

   ![Sign in to Omni dialog with a Sign in with your browser button, and Signing in to chat.xpander.ai with Change below it](https://mintcdn.com/xpanderai-099931d1/5kO48nCPjVxjKi_K/images/desktop/sign-in.png?fit=max\&auto=format\&n=5kO48nCPjVxjKi_K\&q=85\&s=ec019eb73cf75446958de21f52bf8263)

   Sign in to Omni. Shown with sample data.

2. Your browser opens the **Connect Omni Desktop** page. Sign in if you are not already. The page names your Mac, the account and the organization the app will be signed in as. If you did not just choose Sign in in the app on your own computer, close the page.

   ![Browser page asking Connect Omni Desktop? for a computer named Dana's MacBook Pro, with the account and organization, a Connect button and This wasn't me](https://mintcdn.com/xpanderai-099931d1/5kO48nCPjVxjKi_K/images/desktop/connect-page.png?fit=max\&auto=format\&n=5kO48nCPjVxjKi_K\&q=85\&s=fec5b7b9a62756b45882fc448b1e5d07)

   The browser asks before it connects the app. Shown with sample data.

3. Choose **Connect**. The browser opens the app, which finishes signing in on its own.

If the app does not open, choose **The app did not open?** on the browser page to see a one-time code. Copy it, return to the app and paste it under **Sign-in code**, then choose **Continue**. The code works once and expires after a minute.

![Return to Omni page with an Open Omni button and a one-time code with a copy button](https://mintcdn.com/xpanderai-099931d1/5kO48nCPjVxjKi_K/images/desktop/connect-page-code.png?fit=max\&auto=format\&n=5kO48nCPjVxjKi_K\&q=85\&s=aa25b0259ad81571894b73b41c8e9fd8)

The one-time code, for when the app does not open by itself. Shown with sample data.

![Sign-in code field in the app with Open the browser again and Continue](https://mintcdn.com/xpanderai-099931d1/5kO48nCPjVxjKi_K/images/desktop/sign-in-code.png?fit=max\&auto=format\&n=5kO48nCPjVxjKi_K\&q=85\&s=a2d5a9752efaa48268b4b7233e021114)

Pasting the code in the app. Shown with sample data.

If the page says **Omni Desktop is not available**, your organization has not turned Omni Desktop on for you. Ask an admin.

## How long you stay signed in

Your browser session stays in the browser; the app gets its own session for this Mac, kept in the macOS keychain. After 30 days without using the app, it asks you to sign in through the browser again. Sign out from your account menu in the app, or in [Settings](https://docs.xpander.ai/desktop/settings.md).


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