Skip to main content
The Onyx Desktop App provides users with a native application experience for accessing Onyx on Windows, macOS, and Linux. Features include:
  • Quick-launch from system tray or dock
  • Global keyboard shortcuts
  • Desktop notifications
Onyx Desktop App
The desktop app connects to your existing Onyx deployment. Users will need access to your Onyx instance URL.

​
Download

Download the latest Onyx Desktop App for your platform:

Windows

Download for Windows (.exe)

macOS

Download for macOS (.dmg)

Linux

Download for Linux (.deb)
Additional architectures and formats (.msi, .rpm, .app.tar.gz) are available on the GitHub Releases page.

​
Installation Options

Self-hosted users: On first launch, users will need to configure the connection to your Onyx instance:
  • Server URL: Your Onyx instance URL (e.g., https://onyx.yourcompany.com)
  • Authentication: Sign in with your configured authentication method
The desktop app will remember the server URL after initial configuration. Users only need to authenticate on subsequent launches if their session expires.

​
Enterprise Deployment

For organizations deploying the desktop app at scale, you can pre-configure the connection settings.

​
Configuration Options

OptionDescription
server_urlYour Onyx instance URL
window_titleCustom window title