diff --git a/README.rst b/README.rst index d22b49e..8cc6afb 100644 --- a/README.rst +++ b/README.rst @@ -33,6 +33,36 @@ Firefox trademark, held by Mozilla), so you will need to set ``nixpkgs.config.allowUnfree`` in order to use them. More info `here `_. +Flake usage +~~~~~~~~~~~ + +Latest versions of Firefox can be started using flakes, as follows: + +``nix run --impure -no-write-lock-file github:mozilla/nixpkgs-mozilla?dir=flakes/nixos-22.11#firefox-nightly`` + +- The ``--impure`` command line argument is used to allow pulling the latest + pre-built version of Firefox from `archive.mozilla.org`, and checking for the + correct binary signature. + +- The ``--no-write-lock-file`` command line argument is to work-around the fact + that this repository does not include lock files. This repository deliberately + does not include lock files! This is made on purpose to use the latest version + of Nixpkgs with all the security fixes applied, instead of using a frozen + version of Nixpkgs anchored in the past which might have known + vulnerabilities. + +- The ``github:mozilla/nixpkgs-mozilla`` is this repository, each flake contains a + commented line in case you might want to use local path instead. + +- The ``?dir=flakes/nixos-22.11`` is used to refer to the non-default flake + which includes a specific version of Nixpkgs. This one can be changed based on + the content of the `flakes` directory, such as ``?dir=flakes/nixos-unstable``. + +- The ``#firefox-nightly`` is the package name, which is also the default in + this case, and can be omitted when looking at firefox-nightly. This can also + be replaced to use different versions such as `firefox-beta`, + `firefox-release` and `firefox-esr`. + Rust overlay ------------ @@ -72,6 +102,7 @@ Example of using in ```shell.nix```: Flake usage ----------- + This repository contains a minimal flake interface for the various overlays in this repository. To use it in your own flake, add it as an input to your ``flake.nix``: @@ -89,6 +120,7 @@ an input to your ``flake.nix``: }; }; } + The available overlays are ``nixpkgs-mozilla.overlay`` for the default overlay containing everything, and ``nixpkgs-mozilla.{lib, rust, rr, firefox, git-cinnabar}-overlay`` diff --git a/firefox-overlay.nix b/firefox-overlay.nix index b2c4935..1352746 100644 --- a/firefox-overlay.nix +++ b/firefox-overlay.nix @@ -157,7 +157,10 @@ let requiredArgs = { "${nameArg}" = "firefox"; - pname = "firefox-bin"; + # Note: the default for binary wouldbe to include the -bin suffix, + # however the pname aliases the default program to be used with `nix + # run` command. + pname = "firefox"; desktopName = version.name; }; diff --git a/flakes/flake.nix b/flakes/flake.nix new file mode 100644 index 0000000..2c893c5 --- /dev/null +++ b/flakes/flake.nix @@ -0,0 +1,21 @@ +{ + inputs = { + nixpkgs.url = "nixpkgs/nixos-unstable"; + # nixpkgs-mozilla.url = "/local/path/to/nixpkgs-mozilla"; + nixpkgs-mozilla.url = "github:mozilla/nixpkgs-mozilla/master"; + }; + + outputs = {nixpkgs, nixpkgs-mozilla, ...}: + let + latest = (import nixpkgs { + overlays = [ nixpkgs-mozilla.overlays.firefox ]; + system = "x86_64-linux"; + }).latest; + in { + packages."x86_64-linux".default = latest.firefox-nightly-bin; + packages."x86_64-linux".firefox-nightly = latest.firefox-nightly-bin; + packages."x86_64-linux".firefox-beta = latest.firefox-beta-bin; + packages."x86_64-linux".firefox-release = latest.firefox-release-bin; + packages."x86_64-linux".firefox-esr = latest.firefox-esr-bin; + }; +} diff --git a/flakes/nixos-22.11/flake.nix b/flakes/nixos-22.11/flake.nix new file mode 100644 index 0000000..37dfd82 --- /dev/null +++ b/flakes/nixos-22.11/flake.nix @@ -0,0 +1,12 @@ +{ + inputs = { + nixpkgs.url = "nixpkgs/nixos-22.11"; + # nixpkgs-mozilla.url = "/local/path/to/nixpkgs-mozilla/flakes"; + nixpkgs-mozilla.url = "github:mozilla/nixpkgs-mozilla/master?dir=flakes"; + nixpkgs-mozilla.inputs.nixpkgs.follows = "nixpkgs"; + }; + + outputs = {nixpkgs-mozilla, ...}: { + inherit (nixpkgs-mozilla) packages; + }; +} \ No newline at end of file diff --git a/flakes/nixos-unstable/flake.nix b/flakes/nixos-unstable/flake.nix new file mode 100644 index 0000000..00c3bb1 --- /dev/null +++ b/flakes/nixos-unstable/flake.nix @@ -0,0 +1,12 @@ +{ + inputs = { + nixpkgs.url = "nixpkgs/nixos-unstable"; + # nixpkgs-mozilla.url = "/local/path/to/nixpkgs-mozilla/flakes"; + nixpkgs-mozilla.url = "github:mozilla/nixpkgs-mozilla/master?dir=flakes"; + nixpkgs-mozilla.inputs.nixpkgs.follows = "nixpkgs"; + }; + + outputs = {nixpkgs-mozilla, ...}: { + inherit (nixpkgs-mozilla) packages; + }; +} \ No newline at end of file