Nix (command): Difference between revisions

(11 intermediate revisions by 5 users not shown)

Line 1:

This article is about the new ~~<code>~~nix~~</code>~~ command ~~and all of its subcommands~~. ~~The new <code>nix</code> command is intended~~ to ~~unify many different nix utilities that exist currently as many separate commands~~, ~~eg. <code>nix-build</code>, <code>nix-shell</code>, etc~~.

{{Disambiguation|message=This article is about the new nix command. Not to be confused with the [[Nix ecosystem]], the [[Nix (language)|Nix language]] or the [[Nix (package manager)|Nix package manager]].}}

This article is ~~written for~~ nix 2.~~4 or newer~~. ~~Older~~ nix ~~versions might have different~~ commands.

This article is about the new <code>nix</code> command and all of its subcommands. The new <code>nix</code> command is intended to unify many different Nix package manager utilities that exist currently as many separate commands, eg. <code>nix-build</code>, <code>nix-shell</code>, etc.

See the [https://nixos.org/manual/nix/stable/command-ref/experimental-commands.html Nix manual] for a complete reference.

== Enabling the nix command ==

In nix 2.4 the nix command must be enabled ~~explicitly set~~. You can do this in a few different ways.

In nix 2.4, the nix command must be explicitly enabled. You can do this in a few different ways.

~~For~~ an individual invocation~~, eg.~~

=== As an individual invocation ===

<~~syntaxHighlight~~>

nix --experimental-features nix-command build ...

</syntaxhighlight>

=== By setting it in the nix configuration ===

{{File|3=experimental-features = nix-command|name=~/.config/nix/nix.conf|lang=toml}}

=== On NixOS, by setting it in the NixOS configuration ===

''On NixOS you can't edit <code>/etc/nix/nix.conf</code> directly, so you have to set it through the NixOS configuration instead''

{{File|3={ pkgs, ... }: {

nix.settings.experimental-features = [ "nix-command" ];

}|name=/etc/nixos/configuration.nix|lang=nix}}{{Evaluate}}

== Switching from <code>nix profile</code> to <code>nix-env</code> ==

Once you installed a package with <code>nix profile</code>, you get the following error message when using <code>nix-env</code>:

$ nix-env -f '<nixpkgs>' -iA 'hello'

error: --- Error ----------------------------------------------------------------------------------------------------------------- nix-env

profile '/nix/var/nix/profiles/per-user/joerg/profile' is incompatible with 'nix-env'; please use 'nix profile' instead

</syntaxHighlight>

~~Or by setting a user~~-~~specific configuration~~,

To migrate from <code>nix profile</code> to <code>nix-env</code>, you need to delete your current profile:

~~# ~~~/~~.config~~/nix/~~nix.conf~~

{{warning|This will delete packages that have been installed before, so you may want to back this information before running the command.}}

~~experimental~~-~~features = nix-command~~

$ rm -rf /nix/var/nix/profiles/per-user/$USER/profile

</syntaxHighlight>

~~in <code>~/.config/nix/nix.conf</code>.~~

~~Or system-wide with~~

== New equivalents to old commands ==

<~~syntaxHighlight~~ lang=~~nix~~>

# ~~/etc/~~nix/nix~~.conf~~

# create a store derivation for a package defined in the current directory's default.nix

~~{ pkgs,~~ ..~~. }: {~~

old$ nix-instantiate -A somepackage

nix.~~extraOptions =~~ ''

# assumes you are now using flakes

~~experimental-features =~~ nix~~-command~~

new$ nix eval .#somepackage.drvPath

~~'';~~

# alternative option

}

new$ nix derivation show .#somepackage | jq '.[keys[0]]' | nix derivation add

~~</syntaxHighlight>~~

</syntaxhighlight>

~~in <code>/etc/nix/nix.conf~~</~~code~~> ~~on NixOS.~~

[[Category:Nix]]

@@ Line 1: / Line 1: @@
-This article is about the new <code>nix</code> command and all of its subcommands. The new <code>nix</code> command is intended to unify many different nix utilities that exist currently as many separate commands, eg. <code>nix-build</code>, <code>nix-shell</code>, etc.
+{{Navbox Nix}}
+{{Disambiguation|message=This article is about the new nix command. Not to be confused with the [[Nix ecosystem]], the [[Nix (language)|Nix language]] or the [[Nix (package manager)|Nix package manager]].}}
-This article is written for nix 2.4 or newer. Older nix versions might have different commands.
+This article is about the new <code>nix</code> command and all of its subcommands. The new <code>nix</code> command is intended to unify many different Nix package manager utilities that exist currently as many separate commands, eg. <code>nix-build</code>, <code>nix-shell</code>, etc.
+See the [https://nixos.org/manual/nix/stable/command-ref/experimental-commands.html Nix manual] for a complete reference.
 == Enabling the nix command ==
-In nix 2.4 the nix command must be enabled explicitly set. You can do this in a few different ways.
+In nix 2.4, the nix command must be explicitly enabled. You can do this in a few different ways.
-For an individual invocation, eg.
+=== As an individual invocation ===
-<syntaxHighlight>
+<syntaxhighlight lang="console">
 nix --experimental-features nix-command build ...
+</syntaxhighlight>
+=== By setting it in the nix configuration ===
+{{File|3=experimental-features = nix-command|name=~/.config/nix/nix.conf|lang=toml}}
+=== On NixOS, by setting it in the NixOS configuration ===
+''On NixOS you can't edit <code>/etc/nix/nix.conf</code> directly, so you have to set it through the NixOS configuration instead''
+{{File|3={ pkgs, ... }: {
+  nix.settings.experimental-features = [ "nix-command" ];
+}|name=/etc/nixos/configuration.nix|lang=nix}}{{Evaluate}}
+== Switching from <code>nix profile</code> to <code>nix-env</code> ==
+{{Warning|Using <code>nix-env</code> is not recommended.}}
+Once you installed a package with <code>nix profile</code>, you get the following error message when using <code>nix-env</code>:
+<syntaxHighlight lang=console>
+$ nix-env -f '<nixpkgs>' -iA 'hello'
+error: --- Error ----------------------------------------------------------------------------------------------------------------- nix-env
+profile '/nix/var/nix/profiles/per-user/joerg/profile' is incompatible with 'nix-env'; please use 'nix profile' instead
 </syntaxHighlight>
-Or by setting a user-specific configuration,
+To migrate from <code>nix profile</code> to <code>nix-env</code>, you need to delete your current profile:
-<syntaxHighlight lang=toml>
-# ~/.config/nix/nix.conf
+{{warning|This will delete packages that have been installed before, so you may want to back this information before running the command.}}
-experimental-features = nix-command
+<syntaxHighlight lang=console>
+$ rm -rf /nix/var/nix/profiles/per-user/$USER/profile
 </syntaxHighlight>
-in <code>~/.config/nix/nix.conf</code>.
-Or system-wide with
+== New equivalents to old commands ==
-<syntaxHighlight lang=nix>
+<syntaxhighlight lang="shell">
-# /etc/nix/nix.conf
+# create a store derivation for a package defined in the current directory's default.nix
-{ pkgs, ... }: {
+old$ nix-instantiate -A somepackage
-   nix.extraOptions = ''
+# assumes you are now using flakes
-      experimental-features = nix-command
+new$ nix eval .#somepackage.drvPath
-   '';
+# alternative option
-}
+new$ nix derivation show .#somepackage | jq '.[keys[0]]' | nix derivation add
-</syntaxHighlight>
+</syntaxhighlight>
-in <code>/etc/nix/nix.conf</code> on NixOS.
 [[Category:Nix]]