Ways to install
The download page, Terminal and MDM install the build fromhttps://<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 (team76H3VNMG43) and notarized by Apple.
- Download the
.dmgfor your Mac and open it. - Drag Omni into Applications.
- Open Omni from Applications.
/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:.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
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.aias 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.

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

An address set by your organization. Shown with sample data.
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.-
Choose Sign in with your browser. The dialog names the xpander, and Change goes back to the address.

Sign in to Omni. Shown with sample data.
-
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.

The browser asks before it connects the app. Shown with sample data.
- Choose Connect. The browser opens the app, which finishes signing in.
The app did not open: use the one-time code
The app did not open: use the one-time code

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

Pasting the code in the app. Shown with sample data.
How long you stay signed in
How long you stay signed in
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 withapt 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.

A new version is ready. Shown with sample data.

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

