Firefox: Difference between revisions

From NixOS Wiki
imported>Artturin
m add reference and organize
imported>Vater
No edit summary
Line 3: Line 3:


==Installation==
==Installation==
Nix offers multiple ways to install Firefox.
Nix offers multiple ways to install {{PAGENAME}}.


===Using Nix===
===Using Nix===
Firefox may be normally installed by using the <code>firefox</code> package.
{{PAGENAME}} may be normally installed by using the <code>firefox</code> package.
 
<syntaxhighlight lang="bash">sudo $EDITOR /etc/nixos/configuration.nix</syntaxhighlight>
 
<syntaxhighlight lang="nix"></syntaxhighlight>
<syntaxhighlight lang="nix">
  environment.systemPackages = with pkgs; [
</syntaxhighlight>
<syntaxhighlight lang="nix"></syntaxhighlight>
<syntaxhighlight lang="nix">
    firefox
</syntaxhighlight>
<syntaxhighlight lang="nix"></syntaxhighlight>
<syntaxhighlight lang="nix">
  ];
</syntaxhighlight>
<syntaxhighlight lang="nix"></syntaxhighlight>


===Using Home Manager===
===Using Home Manager===
Nix's [[Home Manager]] provides a configuration option for managing Firefox profiles. To allow Home Manager to manage Firefox, you should set the following option in your <code>home.nix</code>:
{{PAGENAME}} also could be installed by using [[Home Manager]].
 
<syntaxhighlight lang="bash">$EDITOR ~/.config/nixpkgs/home.nix</syntaxhighlight>
 
<syntaxhighlight lang="nix">
<syntaxhighlight lang="nix">
programs.firefox.enable = true;
{ pkgs, ... }:
 
{
</syntaxhighlight>
</syntaxhighlight>
<syntaxhighlight lang="nix"></syntaxhighlight>
<syntaxhighlight lang="nix">
  programs.firefox.enable = true;
</syntaxhighlight>
<syntaxhighlight lang="nix"></syntaxhighlight>
<syntaxhighlight lang="nix">
}
</syntaxhighlight>
[[Home Manager]] provides a lot of other options to manage {{PAGENAME}}. You can find them below the [https://rycee.gitlab.io/home-manager/options.html#opt-programs.firefox.enable the Configuration Option ''programs.firefox.enable'' entry in the Home Manager Manual].


For more information on managing Firefox with Home Manager, please refer to [https://rycee.gitlab.io/home-manager/options.html#opt-programs.firefox.enable Home Manager's manual's Firefox section ].
[[Home Manager]] provides a configuration option for managing Firefox profiles.


==Other Editions==
==Other Editions==
Line 94: Line 125:


For example:  
For example:  
 
<syntaxhighlight lang="bash">firefox</syntaxhighlight>
<syntaxhighlight>
<syntaxhighlight lang="bash">
firefox
1554035168269 Marionette FATAL Error de análisis XML: entidad indefinida
1554035168269 Marionette FATAL Error de análisis XML: entidad indefinida
Ubicación: chrome://browser/content/browser.xul
Ubicación: chrome://browser/content/browser.xul
Línea 2526, columna 13:            <toolbarbutton id="tracking-protection-preferences-button"
Línea 2526, columna 13:            <toolbarbutton id="tracking-protection-preferences-button"
JavaScript error: resource:///modules/aboutpages/AboutPrivateBrowsingHandler.jsm, line 28: TypeError: this.pageListener is undefined
JavaScript error: resource:///modules/aboutpages/AboutPrivateBrowsingHandler.jsm, line 28: TypeError: this.pageListener is undefined
</syntaxhighlight>
</syntaxhighlight>


An easy way to get away from this is to start firefox with the <syntaxhighlight>firefox -safe-mode </syntaxhighlight> command. Then you can troubleshoot your actual problem or you can call your luck by calling the refresh option (a special button will appear when firefox starts in this mode). This will reset your configuration to a sane state and you will be usually able to start the browser again, but you will lose most of your customization.  
An easy way to get away from this is to start firefox with the command <code>firefox -safe-mode</code>. Then you can troubleshoot your actual problem or you can call your luck by calling the refresh option (a special button will appear when firefox starts in this mode). This will reset your configuration to a sane state and you will be usually able to start the browser again, but you will lose most of your customization.  


=== nativeMessagingHosts don't work ===
=== nativeMessagingHosts don't work ===

Revision as of 20:21, 15 November 2020

Firefox is a graphical web browser developed by Mozilla.

Installation

Nix offers multiple ways to install Firefox.

Using Nix

Firefox may be normally installed by using the firefox package.

sudo $EDITOR /etc/nixos/configuration.nix
  environment.systemPackages = with pkgs; [
    firefox
  ];

Using Home Manager

Firefox also could be installed by using Home Manager.

$EDITOR ~/.config/nixpkgs/home.nix
{ pkgs, ... }:

{
  programs.firefox.enable = true;
}

Home Manager provides a lot of other options to manage Firefox. You can find them below the the Configuration Option programs.firefox.enable entry in the Home Manager Manual.

Home Manager provides a configuration option for managing Firefox profiles.

Other Editions

Nixpkgs also offers other variants of Firefox aside from the ones stated above. These may suit your needs more comfortably than vanilla Firefox.

Note: The packages for the variants listed below are installed instead of the normal firefox package and each other, which means that you'll have to choose one among these options.

Wayland

Users running a Wayland compositor (such as Sway) may want to use a Wayland-compatible build of Firefox. This can be achieved by replacing the firefox package with firefox-wayland instead.

Firefox ESR

This is the Extended Support Release of Firefox provided by Mozilla, this release receives only security updates and possesses a more relaxed cadence of feature implementation. You can install it by using the firefox-esr package.

Mozilla Distributed Binaries

Mozilla themselves provide official pre-built Firefox binaries. It is possible to install these packages through Nix by using the -bin suffix with the package. So you'd use firefox-bin instead of the normal package. This will download the binary from Mozilla's servers and install it on your system.

Firefox nightly

Nightly builds are daily builds of Firefox from the Mozilla-central repository

To use them

nixpkgs.overlays =
  let
    # Change this to a rev sha to pin
    moz-rev = "master";
    moz-url = builtins.fetchTarball { url = "https://github.com/mozilla/nixpkgs-mozilla/archive/${moz-rev}.tar.gz";};
    nightlyOverlay = (import "${moz-url}/firefox-overlay.nix");
  in [
    nightlyOverlay
  ];
environment.systemPackages = with pkgs; [ latest.firefox-nightly-bin ];

FAQ

How to run Firefox without pulseaudio and still get audio output?

Replace libpulseaudio by libpressureaudio, which uses apulse to emulate PulseAudio but uses ALSA directly. So, you don't need to install/enable pulse audio.

{ pkgs ? import <nixpkgs> {} }:
(pkgs.wrapFirefox.override {libpulseaudio = pkgs.libpressureaudio;}) pkgs.firefox-unwrapped {}

and installing it with nix-env -f firefox.nix -i.

When using Home Manager, add the following to your configuration:

programs.firefox.package = (pkgs.wrapFirefox.override { libpulseaudio = pkgs.libpressureaudio; }) pkgs.firefox-unwrapped { };

I want Firefox, what is Nightly?

Mozilla's trademarks on Firefox disallows distributing unofficial builds using the Firefox trademark. This is why the Nix-built Firefox is named Nightly.

The official builds are available by enabling unfree and installing firefox-bin.

Firefox ESR and Oracle JDK

Note: It is not clear whether this section is out of date, and whether any Firefox release in Nixpkgs allows to use Java. See https://github.com/NixOS/nixpkgs/issues/84909.

Firefox stops support of Java plugin. To use Java plugin you have to use special Firefox ESR, Extended Support Release.

Also, Oracle doesn't provide a nice way to automate Oracle JDK installation without accepting the license. See https://gist.github.com/danbst/30165b59996fb403068c74a95b108d6f for possible way to combine automated JDK and Firefox ESR download.

Repo extensions

Enabling Plasma Browser Integration

1. Add following line to your configuration.nix: nixpkgs.config.firefox.enablePlasmaBrowserIntegration = true;

If you're wondering where this part is coming from see NixOS Manual:Customising Packages

2. Install KDE's Firefox extension: Link

Troubleshooting

If you can't start the browser because of a configuration error.

For example:

firefox
1554035168269	Marionette	FATAL	Error de análisis XML: entidad indefinida
Ubicación: chrome://browser/content/browser.xul
Línea 2526, columna 13:            <toolbarbutton id="tracking-protection-preferences-button"
JavaScript error: resource:///modules/aboutpages/AboutPrivateBrowsingHandler.jsm, line 28: TypeError: this.pageListener is undefined

An easy way to get away from this is to start firefox with the command firefox -safe-mode. Then you can troubleshoot your actual problem or you can call your luck by calling the refresh option (a special button will appear when firefox starts in this mode). This will reset your configuration to a sane state and you will be usually able to start the browser again, but you will lose most of your customization.

nativeMessagingHosts don't work

such as enablePlasmaBrowserIntegration, enableGnomeExtensions, and enableBrowserpass

They do not work with the firefox-bin derivation[1] or with firefox installed via nix-env