windows/README.md
2022-09-28 22:44:15 +02:00

3.2 KiB

Download latest release

  • Visit the FAQ.
  • Install via chocolatey: choco install librewolf
  • Or install via winget: winget install librewolf
  • Or install via scoop: scoop bucket add extras, then scoop install librewolf

Update plugins

There are plugins that help update librewolf, which helps improve securitiy.

  • Guillaume created a windows updater script for the Task Scheduler. it can be found here.
  • Defkev created a LibreWolf updater plugin, which can be found here.

LibreWolf for windows

  • The latest type of .zip files allows for a user profile inside the extracted folder. It is self-contained and runs on removable storage. LibreWolf has many ui languages built-in, available in the settings.

Where to submit tickets

Linux builds

Tested on: fedora36, ubuntu22 vm/vps minimal-ish specs:

  • 4 core cpu
  • 17gb RAM
  • 50gb storage

On the commandline, it's mostly a matter of doing once:

## pick build type:
# cd linux
# cd linux-mar

make fetch

## pick your os:
# sudo make setup-fedora
# sudo make setup-debian

make bootstrap

Then, to build:

make all

That should produce the (non-updating) setup.exe and the community portable zip.

There is a second directory linux-mar where you can build the so-called .mar version of LibreWolf. This is te version that will be auto-updating someday. It's great, but it's main drawback is theming bugs.

You can force a rebuild with make clean all. Please always use make fetch as a single make command, else there might be bugs in the version files. The make fetch command gets you the current latest version.

Compiling the windows version natively

(With the arrival of the linux cross-compiled builds, this is no longer preferred.)

This segment is for people who want to build LibreWolf for themselves. The build of the LibreWolf source tarball is in public CI, so you can use that. Given that you have followed the steps in the Mozilla setup guide:

Once that works, you can check out and compile LibreWolf like this:

git clone https://gitlab.com/librewolf-community/browser/windows.git
cd windows
make fetch build artifacts

This will produce the -setup.exe and portable .zip. Have fun!

Uploading a release

To actually submit these artifacts to the Windows repository for release, use:

python3 mk.py upload <token>

This produces an upload.txt file that contains all needed information about the uploaded files. Please note that this script not only requires a gitlab token, but also a gpg signing key.