diff options
author | Daniel Thwaites <danthwaites30@btinternet.com> | 2022-11-10 19:07:37 +0000 |
---|---|---|
committer | Daniel Thwaites <danthwaites30@btinternet.com> | 2022-11-10 19:07:37 +0000 |
commit | 01b3d0bf257fab99617e8583814717668ef6f736 (patch) | |
tree | f81e3b6d3c8c7594a98963846cf56664feb4e51b /nixos/modules/programs | |
parent | 717ccacc16e8de01ff06f2f83db6415c01f11527 (diff) |
nixos/firefox: init
Diffstat (limited to 'nixos/modules/programs')
-rw-r--r-- | nixos/modules/programs/firefox.nix | 91 |
1 files changed, 91 insertions, 0 deletions
diff --git a/nixos/modules/programs/firefox.nix b/nixos/modules/programs/firefox.nix new file mode 100644 index 0000000000000..76e6c1a553f3a --- /dev/null +++ b/nixos/modules/programs/firefox.nix @@ -0,0 +1,91 @@ +{ pkgs, config, lib, ... }: + +with lib; + +let + cfg = config.programs.firefox; + + policyFormat = pkgs.formats.json { }; + + organisationInfo = '' + When this option is in use, Firefox will inform you that "your browser + is managed by your organisation". That message appears because NixOS + installs what you have declared here such that it cannot be overridden + through the user interface. It does not mean that someone else has been + given control of your browser, unless of course they also control your + NixOS configuration. + ''; + +in { + options.programs.firefox = { + enable = mkEnableOption (mdDoc "the Firefox web browser"); + + package = mkOption { + description = mdDoc "Firefox package to use."; + type = types.package; + default = pkgs.firefox; + defaultText = literalExpression "pkgs.firefox"; + relatedPackages = [ + "firefox" + "firefox-beta-bin" + "firefox-bin" + "firefox-devedition-bin" + "firefox-esr" + "firefox-esr-wayland" + "firefox-wayland" + ]; + }; + + policies = mkOption { + description = mdDoc '' + Group policies to install. + + See [Mozilla's documentation](https://github.com/mozilla/policy-templates/blob/master/README.md") + for a list of available options. + + This can be used to install extensions declaratively! Check out the + documentation of the `ExtensionSettings` policy for details. + + ${organisationInfo} + ''; + type = policyFormat.type; + default = {}; + }; + + preferences = mkOption { + description = mdDoc '' + Preferences to set from `about://config`. + + Some of these might be able to be configured more ergonomically + using policies. + + ${organisationInfo} + ''; + type = with types; attrsOf (oneOf [ bool int string ]); + default = {}; + }; + }; + + config = mkIf cfg.enable { + environment.systemPackages = [ cfg.package ]; + + environment.etc."firefox/policies/policies.json".source = + let policiesJSON = + policyFormat.generate + "firefox-policies.json" + { inherit (cfg) policies; }; + in mkIf (cfg.policies != {}) "${policiesJSON}"; + + # Preferences are converted into a policy + programs.firefox.policies = + mkIf (cfg.preferences != {}) + { + Preferences = (mapAttrs (name: value: { + Value = value; + Status = "locked"; + }) cfg.preferences); + }; + }; + + meta.maintainers = with maintainers; [ danth ]; +} |