The Onyx Chrome Extension allows users to access Onyx from anywhere in their browser. Features include:
  • An Onyx browser home page
  • Favorite website bookmarks
  • An Onyx sidebar in your browser
Coming soon: Ask questions about the page you’re viewing and index visited pages into your Onyx knowledge base!
Onyx Chrome Extension Home Page

​
Installation Options

Onyx Cloud users: Install directly from the Chrome Web Store Self-hosted users: Your administrator will provide installation instructions

​
Manual Installation (Self-Hosted)

1

Get the extension files

Clone the Onyx Chrome Extension repo from GitHub.
2

Enable Developer Mode

  • Visit chrome://extensions/ in your Chrome browser
  • In the upper right corner, click Developer mode to enable it
Chrome Extension Developer Mode
3

Load the extension

  • Click Load unpacked
  • Select the folder containing the Onyx Chrome Extension files
  • Click Load
The extension is now installed and ready to configure.
4

Configure connection settings

  • Click the three dots (…) next to the extension
  • Select Options
  • Set the Root Domain to your self-hosted Onyx instance’s URL
Extension Settings MenuRoot Domain Configuration
The extension will now connect to your self-hosted Onyx instance and can be used from any page in Chrome.

​
Enterprise Deployment

For organizations deploying the extension at scale, use Google Admin Console for centralized management.
1

Access Chrome Management

  • Log in to your Google Admin console
  • Navigate to Devices → Chrome → Apps and extensions
2

Add the extension

  • Obtain the Chrome extension ID from an Onyx team member
  • Click the yellow plus icon to add the extension
  • Enter the Chrome extension ID and click Add
3

Configure deployment

Configure deployment options such as:
  • Force installation for specific organizational units
  • User access controls
  • Update policies and version management
  • Installation policies (allowed, forced, or blocked)
4

Save configuration

Remember to save your changes after configuring the extension settings.

​
Self-Hosting the Extension

For private distribution without the Chrome Web Store:
  1. Package the extension: Use Chrome’s developer tools to create a CRX file
  2. Host the files: Place the CRX and update manifest on your server
  3. Configure clients: Use Admin console or Group Policy to point to your hosted files

​
Extension Management

​
Update Policies

  • Enterprise deployments: Chrome handles automatic updates every 5 hours
  • Version pinning: Available for force-installed extensions, but avoid extended use due to security updates
  • Self-hosted updates: Increment version in manifest.json and replace hosted files