# Chrome Extension

Use Quor in Chrome from any page

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

Features include:

- An Quor browser home page
- An Quor 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 Quor knowledge base!
</Info>

<img className="rounded-image" src="/assets/overview/onyx_anywhere/onyx_chrome_extension.png" alt="Quor Chrome Extension Home Page"/>

## Installation Options

**Quor 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 [Quor 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="/assets/deployment/chrome_extension.png" alt="Chrome Extension Developer Mode"/>
  </Step>

  <Step title="Load the extension">
    - Click **Load unpacked**
    - Select the folder containing the Quor 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 Quor instance's URL

    <img className="rounded-image" src="/assets/deployment/extension_settings.png" alt="Extension Settings Menu"/>

    <img className="rounded-image" src="/assets/deployment/root_domain.png" alt="Root Domain Configuration"/>
  </Step>
</Steps>

<Note>
  The extension will now connect to your self-hosted Quor 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 Quor 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