From c1567aca00a8af1dc4c9432922064da448b49224 Mon Sep 17 00:00:00 2001 From: Adrian Bonpin Date: Wed, 19 Aug 2026 03:04:34 +0800 Subject: [PATCH] docs: add self-hosted Firefox install route (about:config) while AMO is under maintenance --- README.md | 37 +++++++++++++++++++++++++++++++++++++ 1 file changed, 37 insertions(+) diff --git a/README.md b/README.md index b4e78f7..71b0e60 100644 --- a/README.md +++ b/README.md @@ -54,6 +54,43 @@ One codebase builds for **both browsers** (see [Build](#build)). > For a persistent install, package and publish via Firefox AMO / Chrome Web Store > with the same built zips. +## Distribute to real users + +### Firefox (self-hosted, temporary) + +> **Note:** Firefox blocks unsigned extensions for normal installs. The proper +> fix is to sign the add-on via **addons.mozilla.org (AMO)** and publish it there +> (or self-host a signed `.xpi`). AMO is currently **under maintenance**, so until +> it returns, the only way to install the unsigned build is to lower Firefox's +> signing check on each user's machine. This is a per-user browser setting and is +> **not** suitable for a broad audience — use it for personal / small-group use. + +1. Build the Firefox variant (or download `ismis-helper-firefox.zip` from a release): + ```bash + node scripts/build.js firefox + ``` +2. In Firefox, open `about:config` and accept the warning. +3. Search for `xpinstall.signatures.required` and set it to **`false`**. +4. **Restart Firefox** for the change to take effect. +5. Install the add-on from the release zip: drag `ismis-helper-firefox.zip` into + Firefox (or File → Open File… and select it). + +> When AMO is back online, prefer the signed route: publish the same zip to AMO +> (or sign it with `web-ext sign`) so users install it normally without touching +> `about:config`. + +### Chrome (self-hosted) + +Chrome does **not** require signing for normal installs. Users can install the +built `ismis-helper-chrome.zip` directly: + +1. Download `ismis-helper-chrome.zip` from a release and unzip it. +2. Open `chrome://extensions`, enable **Developer mode**, and click **Load unpacked**. +3. Select the unzipped folder. + +> For a store experience, publish the same zip to the Chrome Web Store (one-time +> $5 developer registration). + ## Build Requires **Node.js** (the `build.js` script itself is dependency-free; `npm install`