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

# Installation

> Install Gmail Alias Toolkit from a browser store, a release package, or source

## Recommended installation

Official stores provide the simplest installation and update automatically.

<CardGroup cols={2}>
  <Card title="Chrome Web Store" icon="chrome" href="https://chromewebstore.google.com/detail/cbapjlppdfbnfbopdegobofmfijnlibl">
    Recommended for Google Chrome and most Chromium users.
  </Card>

  <Card title="Firefox Add-ons" icon="firefox-browser" href="https://addons.mozilla.org/addon/gmail-alias-toolkit">
    Install the signed Firefox build and receive normal add-on updates.
  </Card>

  <Card title="Microsoft Edge" icon="edge" href="https://github.com/ePlus-DEV/gmail-alias-toolkit/releases/latest">
    Download the Edge package from the latest GitHub release.
  </Card>

  <Card title="Opera and other Chromium browsers" icon="globe" href="https://github.com/ePlus-DEV/gmail-alias-toolkit/releases/latest">
    Download the matching Opera or Chrome package from GitHub Releases.
  </Card>
</CardGroup>

## Install a release package manually

Download the correct archive from [the latest release](https://github.com/ePlus-DEV/gmail-alias-toolkit/releases/latest):

| Package                                     | Browser                            |
| ------------------------------------------- | ---------------------------------- |
| `gmail-alias-toolkit-{version}-chrome.zip`  | Chrome and other Chromium browsers |
| `gmail-alias-toolkit-{version}-edge.zip`    | Microsoft Edge                     |
| `gmail-alias-toolkit-{version}-opera.zip`   | Opera                              |
| `gmail-alias-toolkit-{version}-firefox.zip` | Firefox temporary/manual testing   |

### Chrome, Edge, Opera, and Chromium browsers

<Steps>
  <Step title="Download and extract the package">
    Extract the ZIP file and keep it in a permanent location. Renaming the folder to `gmail-alias-toolkit` makes later manual updates easier.
  </Step>

  <Step title="Open the extensions page">
    Use `chrome://extensions`, `edge://extensions`, or `opera://extensions`, depending on the browser.
  </Step>

  <Step title="Enable Developer mode">
    Turn on **Developer mode** in the extensions page.
  </Step>

  <Step title="Load the extension">
    Select **Load unpacked**, then choose the extracted `gmail-alias-toolkit` folder.
  </Step>
</Steps>

<Warning>
  A manually loaded extension does not update automatically. Do not delete or move its folder after loading it, or the browser may disable the extension.
</Warning>

### Firefox temporary installation

<Steps>
  <Step title="Extract the Firefox package">
    Download and extract `gmail-alias-toolkit-{version}-firefox.zip`.
  </Step>

  <Step title="Open Firefox debugging">
    Visit `about:debugging#/runtime/this-firefox` and choose **Load Temporary Add-on**.
  </Step>

  <Step title="Select the manifest">
    Select `manifest.json` from the extracted folder.
  </Step>
</Steps>

<Note>
  Temporary Firefox add-ons are removed when Firefox restarts. Use the signed Firefox Add-ons version for normal daily use.
</Note>

## Build from source

**Requirements:** Node.js 24 or newer and Corepack/Yarn.

```bash theme={null}
# Clone the repository
git clone https://github.com/ePlus-DEV/gmail-alias-toolkit.git
cd gmail-alias-toolkit

# Install dependencies
corepack enable
yarn install

# Build Chrome/Chromium
yarn build

# Optional: build Firefox
yarn build:firefox
```

For Chrome or Chromium, load `.output/chrome-mv3` from the browser extensions page. Development and contribution checks are documented in the repository's [`CONTRIBUTING.md`](https://github.com/ePlus-DEV/gmail-alias-toolkit/blob/main/CONTRIBUTING.md).

## Update a manual installation

<Steps>
  <Step title="Download the new package">
    Download and extract the newest package for the same browser.
  </Step>

  <Step title="Replace the existing files">
    Keep the original extension folder path, delete its old contents, and copy in the new package contents.
  </Step>

  <Step title="Reload the extension">
    Return to the browser extensions page and select **Reload** for Gmail Alias Toolkit.
  </Step>
</Steps>

Keeping the same folder path helps the browser preserve the extension identity and locally stored settings.


## Related topics

- [Installation](/google-cloud-skills-boost-helper/installation.md)
- [FAQ](/gmail-alias-toolkit/faq.md)
- [ePlus.DEV Browser Extensions](/index.md)