Skip to main content
Install the app, enter your xpander’s address, then sign in through your browser.

Ways to install

The download page, Terminal and MDM install the build from https://<your xpander>/desktop/, which is chat.xpander.ai/desktop on xpander cloud and Hybrid. Homebrew and apt install from xpander cloud. The web chat also offers the app when you choose Open in Desktop without the app installed. Omni Desktop is not available for Windows.

Install on macOS

For Apple silicon and Intel Macs. Every Mac build is signed with Xpander Inc.’s Developer ID (team 76H3VNMG43) and notarized by Apple.
  1. Download the .dmg for your Mac and open it.
  2. Drag Omni into Applications.
  3. Open Omni from Applications.
The app is installed as /Applications/xpander.ai.app. Finder, the Dock and the menu bar show it as Omni. It lives in the menu bar and opens at login by default (turn Open at login off in Settings). Closing the window keeps it running. Click the dock icon or open the app again to bring the window back.

Install on Linux

For Ubuntu and Debian (x64 and arm64), use the .deb. The AppImage runs on any distribution. Linux builds are not code signed, have no computer control and no MDM path, and do not install updates by themselves. See Where it runs. To install from the signed xpander apt repository, so apt upgrade keeps the app current:

Install from Terminal

On macOS or Linux:
The script downloads the build for your computer and checks its SHA-512 checksum before it installs anything. On a Mac it also checks the code signature. On Linux it installs the .deb where dpkg exists (this needs root or sudo), and the AppImage everywhere else. Add --appimage to install the AppImage without root, or --dry-run to download and check without installing. On an Air-Gapped xpander, use its own script and preset its address:

Install with Homebrew

The app updates itself. brew upgrade --cask xpander works too.

Choose your xpander

On first launch, enter your xpander’s address and choose Continue:
  • xpander cloud: chat.xpander.ai.
  • Hybrid: chat.xpander.ai as well. You sign in on xpander cloud, and your agents run on your install.
  • An Air-Gapped xpander: 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

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.
First run screen with the address field locked and the note Set by your organization

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

    Sign in to Omni. Shown with sample data.

  2. Your browser opens Connect Omni Desktop, naming your computer, 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

    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 a Mac, after you sign in, macOS asks for two permissions so agents can use your apps. See Computer control. Omni Desktop is not available means your organization has not turned it on for you. Ask an admin.
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

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

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

The app keeps its own session for this computer in the macOS keychain (on Linux, the system keyring), 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.

Updates

On a Mac, the app downloads new versions from your xpander by itself. A strip under the title bar names a ready one, for example Omni 1.5.0 is ready, with Restart to update and Later. Settings > About shows the same, and Check for updates… in the Omni menu checks now. While an agent is working on your Mac, the strip adds An agent is working on this Mac. Restarting stops its work., and Later lets the work finish first. On Linux, a notification and About offer the new version as a download, Check for updates… is in the File menu, and the apt repository updates the app with apt upgrade. An Air-Gapped xpander serves its own updates, so the app never needs the internet for them. It serves the build that came with its current version, and newer builds arrive when you upgrade the install.
Strip under the title bar reading Omni 1.5.0 is ready, with Later and Restart to update

A new version is ready. Shown with sample data.

About in Settings: Omni by xpander.ai, Version 1.4.0, and Omni 1.5.0 is ready with Restart to update

Settings > About with an update ready. Shown with sample data.