> ## Documentation Index
> Fetch the complete documentation index at: https://docs.onyx.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Chrome Extension

> Use Onyx in Chrome from any page

The Onyx Chrome Extension allows users to access Onyx from anywhere in their browser.

Features include:

* An Onyx browser home page
* An Onyx sidebar in your browser
* Contextual search on selected text
* Deep Research capabilities

<Info>
  Coming soon: Full page context chat and indexing visited pages into your Onyx knowledge base!
</Info>

<img className="rounded-image" src="https://mintcdn.com/danswer/rmoe4169sPLGRi9x/assets/overview/onyx_anywhere/onyx_chrome_extension.png?fit=max&auto=format&n=rmoe4169sPLGRi9x&q=85&s=dd80200c74ccbf3c7861cf60f9ce68f6" alt="Onyx Chrome Extension Home Page" width="3820" height="1706" data-path="assets/overview/onyx_anywhere/onyx_chrome_extension.png" />

## 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)

<Steps>
  <Step title="Get the extension files">
    Clone the [Onyx Chrome Extension](https://github.com/onyx-dot-app/onyx-chrome-extension) repo from GitHub.
  </Step>

  <Step title="Enable Developer Mode">
    * Visit `chrome://extensions/` in your Chrome browser
    * In the upper right corner, click **Developer mode** to enable it

    <img className="rounded-image" src="https://mintcdn.com/danswer/bNCAyv_0mlX0VYMw/assets/deployment/chrome_extension.png?fit=max&auto=format&n=bNCAyv_0mlX0VYMw&q=85&s=797502d0cca8f5b24531bc661f456750" alt="Chrome Extension Developer Mode" width="2128" height="840" data-path="assets/deployment/chrome_extension.png" />
  </Step>

  <Step title="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.
  </Step>

  <Step title="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

    <img className="rounded-image" src="https://mintcdn.com/danswer/bNCAyv_0mlX0VYMw/assets/deployment/extension_settings.png?fit=max&auto=format&n=bNCAyv_0mlX0VYMw&q=85&s=fed7180d97e40f3a3a23fdf51392f0dc" alt="Extension Settings Menu" width="1244" height="1258" data-path="assets/deployment/extension_settings.png" />

    <img className="rounded-image" src="https://mintcdn.com/danswer/glaei3niibtHdYyZ/assets/deployment/root_domain.png?fit=max&auto=format&n=glaei3niibtHdYyZ&q=85&s=f893d00e0930e4479cc2aa55f3e717c9" alt="Root Domain Configuration" width="950" height="1122" data-path="assets/deployment/root_domain.png" />
  </Step>
</Steps>

<Note>
  The extension will now connect to your self-hosted Onyx instance and can be used from any page in Chrome.
</Note>

## Enterprise Deployment

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

<Steps>
  <Step title="Access Chrome Management">
    * Log in to your Google Admin console
    * Navigate to **Devices → Chrome → Apps and extensions**
  </Step>

  <Step title="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**
  </Step>

  <Step title="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)
  </Step>

  <Step title="Save configuration">
    <Warning>
      Remember to save your changes after configuring the extension settings.
    </Warning>
  </Step>
</Steps>

### Self-Hosting the Extension

For private distribution without the Chrome Web Store:

<Steps>
  <Step title="Package the extension">
    Use Chrome's developer tools to create a CRX file
  </Step>

  <Step title="Host the files">
    Place the CRX and update manifest on your server
  </Step>

  <Step title="Configure clients">
    Use Admin console or Group Policy to point to your hosted files
  </Step>
</Steps>

## 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