about summary refs log tree commit diff
path: root/doc
diff options
context:
space:
mode:
authorgithub-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>2020-12-03 12:18:45 +0000
committerGitHub <noreply@github.com>2020-12-03 12:18:45 +0000
commit5b73e3087ae63d404f94a76781b281e73a33922b (patch)
treeb102caf1088da9353710b3252e45ab3e61bdb453 /doc
parent594ee544b61ff8a026d3d98af90b46d60e67769c (diff)
parent84f417d29beab8e5045a4471a3a288ca3c10c0b9 (diff)
downloadnixlib-5b73e3087ae63d404f94a76781b281e73a33922b.tar
nixlib-5b73e3087ae63d404f94a76781b281e73a33922b.tar.gz
nixlib-5b73e3087ae63d404f94a76781b281e73a33922b.tar.bz2
nixlib-5b73e3087ae63d404f94a76781b281e73a33922b.tar.lz
nixlib-5b73e3087ae63d404f94a76781b281e73a33922b.tar.xz
nixlib-5b73e3087ae63d404f94a76781b281e73a33922b.tar.zst
nixlib-5b73e3087ae63d404f94a76781b281e73a33922b.zip
Merge master into staging-next
Diffstat (limited to 'doc')
-rw-r--r--doc/builders/packages/firefox.section.md40
-rw-r--r--doc/builders/packages/index.xml1
2 files changed, 41 insertions, 0 deletions
diff --git a/doc/builders/packages/firefox.section.md b/doc/builders/packages/firefox.section.md
new file mode 100644
index 000000000000..2f89da2d4595
--- /dev/null
+++ b/doc/builders/packages/firefox.section.md
@@ -0,0 +1,40 @@
+# Firefox
+
+## Build wrapped Firefox with extensions and policies
+
+The `wrapFirefox` function allows to pass policies, preferences and extension that are available to firefox. With the help of `fetchFirefoxAddon` this allows build a firefox version that already comes with addons pre-installed:
+
+```nix
+{
+  myFirefox = wrapFirefox firefox-unwrapped {
+    extraExtensions = [
+      (fetchFirefoxAddon {
+        name = "ublock";
+        url = "https://addons.mozilla.org/firefox/downloads/file/3679754/ublock_origin-1.31.0-an+fx.xpi";
+        sha256 = "1h768ljlh3pi23l27qp961v1hd0nbj2vasgy11bmcrlqp40zgvnr";
+      })
+    ];
+
+    extraPolicies = {
+      CaptivePortal = false;
+      DisableFirefoxStudies = true;
+      DisablePocket = true;
+      DisableTelemetry = true;
+      DisableFirefoxAccounts = true;
+      FirefoxHome = {
+        Pocket = false;
+        Snippets = false;
+      };
+       UserMessaging = {
+         ExtensionRecommendations = false;
+         SkipOnboarding = true;
+       };
+    };
+
+    extraPrefs = ''
+      // Show more ssl cert infos
+      lockPref("security.identityblock.show_extended_validation", true);
+    '';
+  };
+}
+```
diff --git a/doc/builders/packages/index.xml b/doc/builders/packages/index.xml
index baf9b8db01be..c2e7ef9bf61c 100644
--- a/doc/builders/packages/index.xml
+++ b/doc/builders/packages/index.xml
@@ -10,6 +10,7 @@
  <xi:include href="eclipse.xml" />
  <xi:include href="elm.xml" />
  <xi:include href="emacs.section.xml" />
+ <xi:include href="firefox.section.xml" />
  <xi:include href="ibus.xml" />
  <xi:include href="kakoune.section.xml" />
  <xi:include href="linux.section.xml" />