Home Explore Blog Models CI



nix

src/nix/profile-list.md
4b5be56babd786e75e511c3b37a017c427e155ebe52abc6a00000003000007b5
R""(

# Examples

* Show what packages are installed in the default profile:

  ```console
  # nix profile list
  Name:               gdb
  Flake attribute:    legacyPackages.x86_64-linux.gdb
  Original flake URL: flake:nixpkgs
  Locked flake URL:   github:NixOS/nixpkgs/7b38b03d76ab71bdc8dc325e3f6338d984cc35ca
  Store paths:        /nix/store/indzcw5wvlhx6vwk7k4iq29q15chvr3d-gdb-11.1

  Name:               blender-bin
  Flake attribute:    packages.x86_64-linux.default
  Original flake URL: flake:blender-bin
  Locked flake URL:   github:edolstra/nix-warez/91f2ffee657bf834e4475865ae336e2379282d34?dir=blender
  Store paths:        /nix/store/i798sxl3j40wpdi1rgf391id1b5klw7g-blender-bin-3.1.2
  ```

  Note that you can unambiguously rebuild a package from a profile
  through its locked flake URL and flake attribute, e.g.

  ```console
  # nix build github:edolstra/nix-warez/91f2ffee657bf834e4475865ae336e2379282d34?dir=blender#packages.x86_64-linux.default
  ```

  will build the package `blender-bin` shown above.

# Description

This command shows what packages are currently installed in a
profile. For each installed package, it shows the following
information:

* `Name`: A unique name used to unambiguously identify the
  package in invocations of `nix profile remove` and `nix profile
  upgrade`.

* `Index`: An integer that can be used to unambiguously identify the
  package in invocations of `nix profile remove` and `nix profile upgrade`.
  (*Deprecated, will be removed in a future version in favor of `Name`.*)

* `Flake attribute`: The flake output attribute path that provides the
  package (e.g. `packages.x86_64-linux.hello`).

* `Original flake URL`: The original ("unlocked") flake reference
  specified by the user when the package was first installed via `nix
  profile install`.

* `Locked flake URL`: The locked flake reference to which the original
  flake reference was resolved.

* `Store paths`: The store path(s) of the package.

)""

Chunks
78ed7cba (1st chunk of `src/nix/profile-list.md`)
Title: Nix Profile List Command Details and Examples
Summary
This document describes the `nix profile list` command, which displays all packages currently installed in a profile. For each package, it shows details such as its `Name`, `Flake attribute`, `Original flake URL`, `Locked flake URL`, and `Store paths`. The `Name` is used for unambiguous identification in `nix profile remove` and `nix profile upgrade` commands, while the `Index` is noted as deprecated. The `Locked flake URL` and `Flake attribute` together allow for precise and reproducible rebuilding of a package, as illustrated with a `nix build` example for `blender-bin`.