This is a trivial tool to create declarative profiles with Nix flakes. This is achieved with the same mechanisms as used by home-manager and NixOS: nix-env --set, nix-env --list-generations, and nix-env --rollback.

The purpose of this tool is that people stop stubbing their toes on nix profile and nix-env for non-declarative uses on non-NixOS systems by providing a declarative alternative using flakes to pin versions of things.

• Support nix profile list as complained about here. We are in favour of the removal of nix profile from the Nix codebase in lieu of stabilization.

• Compatibility with imperative package management: there is no clear way to share a profile with an imperative setup.

  We might write a migration script in the future that takes nix profile list --json and converts it into a flake.

• Do similar things to home-manager for services or other things. This is just a replacement for nix-env and nix profile and nothing more.

• home-mangler, which uses a few hundred lines of Rust to wrangle nix profile into having exactly the expected packages installed. Their approach makes nix profile list work. By comparison, this project consists of two lines of shell script that bypass nix profile altogether.
• nixos-rebuild, which uses the same methods to achieve its goals.
• home-manager which is implemented via inexplicable cursed crimes for nix profile or the same method as this otherwise.
• Flakes as a unified format for profiles
• Stop Using nix-env

To use it, see the template in templates/default, or included below, or run:

nix flake init -t github:lf-/flakey-profile#templates.default

Flake example:

# SPDX-FileCopyrightText: 2023 Jade Lovelace
#
# SPDX-License-Identifier: CC0-1.0

{
  description = "Basic usage of flakey-profile";

  inputs = {
    flakey-profile.url = "github:lf-/flakey-profile";
    nixpkgs.url = "github:nixos/nixpkgs/nixos-unstable";
    flake-utils.url = "github:numtide/flake-utils";
  };

  outputs = { self, nixpkgs, flake-utils, flakey-profile }:
    flake-utils.lib.eachDefaultSystem (system:
      let
        pkgs = import nixpkgs {
          inherit system;
        };
      in
      {
        # Any extra arguments to mkProfile are forwarded directly to pkgs.buildEnv.
        #
        # Usage:
        # Switch to this flake:
        #   nix run .#profile.switch
        # Revert a profile change (note: does not revert pins):
        #   nix run .#profile.rollback
        # Build, without switching:
        #   nix build .#profile
        # Pin nixpkgs in the flake registry and in NIX_PATH, so that
        # `nix run nixpkgs#hello` and `nix-shell -p hello --run hello` will
        # resolve to the same hello as below [should probably be run as root, see README caveats]:
        #   sudo nix run .#profile.pin
        packages.profile = flakey-profile.lib.mkProfile {
          inherit pkgs;
          # Specifies things to pin in the flake registry and in NIX_PATH.
          pinned = { nixpkgs = toString nixpkgs; };
          paths = with pkgs; [
            hello
          ];
        };
      });
}

Then, use the following commands to do things with the new profile:

nix run .#profile.switch

Warning: This does not rollback the actions of profile.pin. To roll that back, revert to the previous version of the profile using a version control system and run profile.pin again.

nix run .#profile.rollback

nix build .#profile

nix flake lock --update-input nixpkgs

or

nix flake update

then

nix run .#profile.switch

This makes nix run nixpkgs#hello and nix-shell -p hello --run hello give you the same hello as if you listed it in your profile.

nix run .#profile.pin

The flake registry is used to resolve unqualified flake names such as nixpkgs in nix run nixpkgs#hello, and can be overridden on a per-user or system-wide basis. NIX_PATH is used to resolve <nixpkgs> and other references in angle brackets, and if not present, this procedure is used. By running profile.pin, both the flake registry and the channel of the running user will be overridden to point to the nixpkgs you used to build your profile.

It seems that often people run into an issue where /nix/var/nix/profiles/per-user/$USER does not exist. If this is the case, you can simply sudo mkdir -p /nix/var/nix/profiles/per-user/$USER && sudo chown $USER /nix/var/nix/profiles/per-user/$USER. Or, alternatively, nix-env -f '<nixpkgs>' -iA hello might fix it, but if it does not, try the other one.

This has so far been observed on macOS, however we are unsure if this is a Mac only bug.