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

# Chrome Extension

> Use Gorbit in Chrome from any page

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

Features include:

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

<img className="rounded-image" src="https://mintlify.s3.us-west-1.amazonaws.com/gorbit/assets/overview/gorbit_anywhere/gorbit_chrome_extension.png" alt="Gorbit Chrome Extension Home Page" />

## Installation Options

**Gorbit 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 [Gorbit Chrome Extension](https://github.com/gorbit-dot-app/gorbit-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/gorbit/qYeWoSrsnkRPFQDm/assets/deployment/chrome_extension.png?fit=max&auto=format&n=qYeWoSrsnkRPFQDm&q=85&s=7b9ec5721c3aa2e9916dce99f928b584" 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 Gorbit 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 Gorbit instance's URL

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

    <img className="rounded-image" src="https://mintcdn.com/gorbit/qYeWoSrsnkRPFQDm/assets/deployment/root_domain.png?fit=max&auto=format&n=qYeWoSrsnkRPFQDm&q=85&s=829b6fed63849422eae248f0f8e9157a" 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 Gorbit 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 Gorbit 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