Haketilo

# Installation instructions (Mozilla)

Here we'll describe how to install Hachette from a .xpi file. Extensions in Firefox and its derivatives are often installed from Mozilla Add-ons page, but for the sake of privacy and freedom, you should not use it!

Right now we only provide an unsigned .xpi extension file. This means it hasn't been cryptographically signed by Mozilla and therefore some of its browsers will refuse to install it. While we're going to provide a signed version of the extension soon, you are really encouraged to use a Firefox derivative that not only allows you to manage your software but also ~~isn't malware itself~~ respects your freedom and privacy. Valid options are browsers in some of the ["ethical" GNU/Linux distros](https://www.gnu.org/distros/free-distros.html#for-pc) like Parabola and Trisquel, the Tor Browser and LibreWolf (except a bug that appeared around version 90.0 and used to cause extension singatures to be required...). Although not necessarily ethical, browsers based on Firefox ESR (as commonly found in operating systems repositories) should also work.

## Browser compatibility

Hachette is currently compatible with browsers based on Mozilla Firefox 60 and upwards. It has been tested against LibreWolf 90.0.2, Tor Browser 10.0.17, Parabola Iceweasel 75 and IceCat 60 (although for security reasons you should probably avoid browsers as old as the last 2).

## Steps

First, download the extension's .xpi file from  the [[Releases]]. You can also download the .gpg signature to verify the file hasn't been tampered with (although it is of limited benefit unless you have a proof developer's [signing key](https://koszko.org/key.gpg) does indeed belong to him...). After downloading, go to the `about:addons` URL. In the extensions management page that shows up, click on the gear icon and select "Install Add-on From File...".

![mozilla extensions page](https://hachettebugs.koszko.org/attachments/download/49/mozilla_install_from_file.png)

Now, navigate to the downloaded .xpi file and select it.

![navigating to the extension file](https://hachettebugs.koszko.org/attachments/download/50/navigate_extension_xpi_file.png)

*Note: If, at this point, your browser shows you an error message about extension file being invalid, but you're sure the browser supports installation of unsigned extensions, go to the `about:config` URL, confirm the warning prompt that appears, search for the `xpinstall.signatures.required` preference and double-click it to toggle its value to "false".*

You should be presented with a dialog asking whether to add Hachette to your browser. Once you click "Add", the add-on will install.

![adding hachette to mozilla](https://hachettebugs.koszko.org/attachments/download/51/mozilla_add_hachette.png)

The browser might ask whether you want to allow Hachette to run in private windows. If you installed Hachette for its script-blocking capabilities, then you most likely also want that and you can check this option. Otherwise, it is a perfectly valid approach to aim for a purely script-less experience in private browsing windows and use an add-on like NoScript or uBlock Origin there instead of Hachette.

![hachette installed, allowing extension to run in private windows](https://hachettebugs.koszko.org/attachments/download/52/mozilla_hachette_installed_allow_private.png)

That's it. You can now play a bit with the extension and [learn how it works](/projects/hachette/wiki/User_manual#Understanding-the-concepts). Also, make sure you realize its

[limitations](/projects/hachette/wiki/Known_limitations).