> ## 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, enter your xpander's address and choose **Continue**:

* **xpander cloud**: `chat.xpander.ai`.
* **A self-hosted xpander** (Hybrid or Air-gapped): your company's 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.

On a Mac your company manages, the address may be filled in and read **Set by your organization**, which you cannot change. 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.

**Could not reach** means the app cannot get to the address. Check the spelling, your network and, for a self-hosted xpander, your VPN, then choose **Try again**. To switch xpanders later, change the address in [Settings](https://docs.xpander.ai/desktop/settings.md). This signs you out first.

## Sign in through your browser

The app has no sign-in form. You sign in in your browser as usual (single sign-on, Google, GitHub or email), and the browser hands the app its own session for this Mac.

1. Choose **Sign in with your browser**. The dialog names the xpander, and **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 **Connect Omni Desktop**, naming your Mac, the account and the organization. Sign in if needed. If you did not just choose Sign in 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.

If the app does not open, choose **The app did not open?** to see a one-time code. Paste it in the app under **Sign-in code** and 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.

**Omni Desktop is not available** means your organization has not turned it on for you. Ask an admin.

## How long you stay signed in

The app keeps its own session for this Mac in the macOS keychain, separate from your browser's. After 30 days without using the app, it asks you to sign in again. Sign out from your account menu 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.