Appendix A Installation Requirements

A.1 Mozilla Browser

You will need one of the many flavors of the Mozilla browser to use LibreJS. It can be installed on the following:

GNU IceCat, Mozilla Firefox, Trisquel Abrowser, Debian Iceweasel.

LibreJS works on these browsers starting from version 29. We recommend that you use the latest version of your Mozilla browser. LibreJS has been tested extensively on multiple GNU/Linux distributions, but it is compatible any operating system as long as you’re using a compatible Mozilla browser.

A.2 Mozilla’s Add-on SDK

LibreJS uses the Mozilla Add-on SDK (Software Development Kit), a set of APIs and tools to create add-ons for Mozilla browsers.

You do not need the Add-on SDK to use LibreJS xpi file or to install it using the packaged version, but it is required in order to package the LibreJS source code into an xpi file using make. If you would like to run the tests for LibreJS or make changes to the source files, you will need the Add-on SDK as well. For the “make” command to work properly, you must have the cfx command available on your system from the command line.

The latest tarball for the Add-on SDK is available at:

https://ftp.mozilla.org/pub/mozilla.org/labs/jetpack/jetpack-sdk-latest.tar.gz

Instructions on how to get it working are available here:

https://addons.mozilla.org/en-US/developers/docs/sdk/latest/dev-guide/tutorials/installation.html

In order to use make with LibreJS source, however, it is ideal to have cfx available at all times and for all users.

An easy way to do this is to extract the contents of the tarball and to place the files inside /usr/lib/addon-sdk and then creating a symbolic link in /usr/bin, as follows:

sudo ln -s /usr/lib/addon-sdk/bin/cfx /usr/bin/cfx

The cfx command will then be available to all users.

The Add-on SDK is released under the Mozilla Public License 2.0.