How to install Waterfox browser in Linux

There was a topic discussing alternatives to Firefox browser.

I mentioned Waterfox as an alternative with a firm security policy.
Unfortunately the only distro with Waterfox in its package system is Gentoo. Congratulations to the Gentoo package system maintainers.

That means installing Waterfox in any of our commonly used Debian or Arch based distros could be difficult and may deter people from trying it.

There are numerous howto sites pretending to show you how to install Waterfox. The best one (imho) is

It gives two methods

  1. from Flatpak
  2. from a source file

Beware of other howto’s that suggest PPA’s and snaps. They are complicated and dangerous.

I am going to do the install from source in my own machine. This does not mean compiling… the source is a tar file and it contains binaries.

Here is what I did

1. Go to website 
https://www.waterfox.net/
and download it

2.  As suoeruser
   cd /usr/local/src
   mkdir Waterfox
   cd Waterfox
   cp ~/Dow*/waterfox-6.5.5.tar.bz2 .
   bzip2 -dc waterfox-6.5.5.tar.bz2 | tar xvf -

3. As superuser
   cd waterfox
  You will find 2 files waterfox-bin and waterfox.... they are identical
   ln -sv  waterfox /usr/local/bin/waterfox
  make sure /usr/local/bin is in your path

4. Run it
$ waterfox
ATTENTION: default value of option mesa_glthread overridden by environment.
ATTENTION: default value of option mesa_glthread overridden by environment.

When you get to step 4 your screen will look like the following

That is the welcome screen of the Waterfox browser.

The second tab looks like this

That is another place you can download from.
All versions are available, the current version is 6.5.5
You can run Waterfox concurrently with Firefox… they do not interfere… Waterfox has a .waterfox file and Firefox has a .mozilla file.

Why did I install it in /usr/local?
To keep it totally separate from the package system. That is important. External software should never be put in /usr… use usr/local or your home directory or /opt or anywhere outside of /usr that is in your PATH.

You will notice I launched Waterfox from the CLI.
To get a desktop launcher, you need to create a .desktop file.

cd ~/.local/share/applications
vi waterfox.desktop
add the following
[Desktop Entry]
Version=6.0.4
Name=Waterfox
Comment=Web browser
Exec=waterfox
Icon=/usr/local/src/Waterfox/waterfox/browser/chrome/icons/default/default48.png
Terminal=false
Type=Application
Categories=Network;WebBrowser;

Now a Waterfox entry will appear in your Menu under Applications → Internet.
To get an icon in my panel, I need to use the Xfce Panel tool

That is all. Keep it simple… install it by hand… then you will know exactly what you have done to your system.

The only other howt I would recommend is the offician Waterfox page

It basically says the same thing as above… flatpak or source, unless you are lucky enough to have it in your distro’s repo.
Does anyone know of a distro other than Gentoo that has Waterfox in its repo.?

6 Likes

I’ve downloaded and extracted the Waterfox tarball to /opt, as my distros (LMDE) Firefox is at the same place. Then I created a menu item manually. No problem so far.

2 Likes

Good on you. I am glad to see you used the manual install method. Let us know what you experience using Waterfox?

I am having difficulty trying to get the waterfox app to appear in an Xfce panel… apparently the app has to be a plugin before Xfce will add it to a panel.
Otherwise everything in waterfox works for me. It is almost identical to firefox.

3 Likes

I’m on LMDE 6 with Cinnamon 6.4.8. To create the .desktop file, i used Cinnamon’s menu editor, finally I simply selected “Add to panel”.

In the past, I sometimes had trouble with .desktop files created with editor, no clue why.

Here is my generated .desktop file.

[Desktop Entry]
Name=Waterfox
Exec=/opt/waterfox/waterfox
Comment=
Terminal=false
PrefersNonDefaultGPU=false
Icon=/opt/icons8-waterfox-48.png
Type=Application
3 Likes

Thanks,
Maybe that is it? I will check it.
It automatically generates a menu entry,
but,
when I click on

waterfox is not listed as a choice.

Xfce is different… I need to re-learn about setting up panels.

2 Likes

Sparky Linux has Waterfox, Librewolf and Brave in its repos.

3 Likes

If not in repositories you could download direct

Yes, that is what I did… It is not in MX repos.

1 Like

Normally not something i would recommend, prefer repositories first time every time, but occasionally and only if sure of the source being correct.

Yeah sure. Only get the tar file direct from the Waterfox site.

2 Likes

I have discovered that Waterfox is available in the repos of Artix and Antix
but not in Debian12, Devuan5, MX23, or Void.

My initial remark that Gentoo was the only distro with Waterfox was indeed incorrect.
Does anyone know about Ubuntu/Mint?

MX23 has a wide range of browsers


but not Waterfox.

4 Likes

@nevj and all:

Hi Neville, :waving_hand:

Actually I found waterfox in Arch´s AUR packages:

Cheers from Rosika :slightly_smiling_face:

1 Like

OK, so it is only Debian and some derivatives that do not have Waterfox.
How about Lite?. That is Ubuntu based

2 Likes

Hi Neville, :waving_hand:

Nothing here. It´s not installable using the default sources.

  • I looked it up with synaptic. No entry there.
 env LANG=en_GB:en apt-cache show waterfox
N: Unable to locate package waterfox
E: No packages found
 apt search waterfox
Sortierung… Fertig
Volltextsuche… Fertig

No results, whatever method of searching I use.

Cheers from Rosika :slightly_smiling_face:

2 Likes

Did you check the Flatpak tab? I installed it on my MX from there. On Linux Mint (it is not in the repo) I did as you did and downloaded tarball and installed via CLI. I did not do anything else, but when I tried the menu and typed WAT, it appeared in the start menu. Strange.

I also installed it on Debian 12 direct from source. Since you said it was in Antix, I will get it on my mom’s old laptop.

The only thing to me that was strange, and I know little about these things, but everything was related to Firefox, confirmed extensions were from Firefox, etc. Themes were from Firefox. Searching for an extension for “translate”

It opened a new tab in Waterfox and showed FF extensions. Otherwise, I am happy with it for now.

Sheila

2 Likes

No , I did not check that.
Most people would be happy with Flatpak, but I would prefer to install it myself if not in the normal repo.

That is great. At least we have Waterfox as a way out if Mozilla became unacceptably intrusive.
The other alternatives are a bigger step.

It is important to have a more sophisticated user like you test Waterfox. I am only a simple browser user.

2 Likes

This has me intrigued.
In the folder /usr/local/src/Waterfox/waterfox
there are 2 files waterfox and watyerfox-bin
They are identical

nevj@trinity:/usr/local/src/Waterfox/waterfox
$ file waterfox
waterfox: ELF 64-bit LSB pie executable, x86-64, version 1 (SYSV), dynamically linked, interpreter /lib64/ld-linux-x86-64.so.2, for GNU/Linux 2.6.32, BuildID[sha1]=2efb33b11e86d78feba0db10c361093b8e5b40cb, stripped
nevj@trinity:/usr/local/src/Waterfox/waterfox
$ file waterfox-bin
waterfox-bin: ELF 64-bit LSB pie executable, x86-64, version 1 (SYSV), dynamically linked, interpreter /lib64/ld-linux-x86-64.so.2, for GNU/Linux 2.6.32, BuildID[sha1]=2efb33b11e86d78feba0db10c361093b8e5b40cb, stripped
nevj@trinity:/usr/local/src/Waterfox/waterfox
$ cmp waterfox waterfox-bin
nevj@trinity:/usr/local/src/Waterfox/waterfox

They are identical
They both execute.

But if I use firejail

$ firejail /usr/local/src/Waterfox/waterfox/waterfox
....
Error: no suitable /usr/local/src/Waterfox/waterfox/waterfox executable found

and the other one

$ firejail /usr/local/src/Waterfox/waterfox/waterfox-bin
.....
Child process initialized in 82.06 ms
ATTENTION: default value of option mesa_glthread overridden by environment.
ATTENTION: default value of option mesa_glthread overridden by environment.

It is running, but I have permission problems.

What possible difference could a file name make?

Update:
The filename makes a huge difference… it determines which firejail .profile file is used. The first uses waterfox.profile… the second uses default.profile…because there is no waterfox-bin.profile.
In this case the default.profile almost works, but the waterfox.profile fails.
I have work to do on waterfox.profile fro firejail.

2 Likes

Hi Neville, :waving_hand:

That´s a wise thing to do.
Flatpak apps wouldn´t be supported by firejail, like snaps.
Appimages on the other hand are well supported.

Cheers from Rosika :slightly_smiling_face:

2 Likes

Waterfox can be found in the Software manager in Linux Mint 22, as a flatpak, and that is how I installed it. A very simple process. It is an unverified flatpak, so you would need to go into the preferences in the software manager and set it to show unverified flatpaks, then click on the installer to install.

3 Likes