Mirrors/nixos-and-flakes-book
2
0
Fork 0
mirror of https://github.com/ryan4yin/nixos-and-flakes-book synced 2024-11-23 04:33:08 +00:00
Code Issues Projects Releases Packages Wiki Activity

feat: add note for NIX_PATH & nix-channel

Browse source
This commit is contained in:
Ryan Yin 2024-02-17 12:53:24 +08:00
parent db717d9113
commit b77fa261a6
2 changed files with 6 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

3
docs/best-practices/nix-path-and-flake-registry.md
View file

@ -20,8 +20,11 @@ For instance, if we execute `nix run nixpkgs#ponysay hello`, Nix will automatica
## Custom NIX_PATH and Flake Registry {#custom-nix-path-and-flake-registry-1} ## Custom NIX_PATH and Flake Registry {#custom-nix-path-and-flake-registry-1}
> **NOTE: Newcomers should skip this section! Disabling `nix-channel` incorrectly may lead to some headaches.**
The roles of `NIX_PATH` and the Flake Registry have been explained earlier. The roles of `NIX_PATH` and the Flake Registry have been explained earlier.
In daily use, we typically want the `nixpkgs` used in commands like `nix repl '<nixpkgs>'`, `nix run nixpkgs#ponysay hello` to match the system's `nixpkgs`. This requires us to customize the `NIX_PATH` and Flake Registry. In daily use, we typically want the `nixpkgs` used in commands like `nix repl '<nixpkgs>'`, `nix run nixpkgs#ponysay hello` to match the system's `nixpkgs`. This requires us to customize the `NIX_PATH` and Flake Registry.
On the other hand, although `nix-channel` can coexist with the Flakes feature, in practice, Flakes can completely replace it, so we can also disable it.
In your NixOS configuration, adding the following module will achieve the mentioned requirements: In your NixOS configuration, adding the following module will achieve the mentioned requirements:

3
docs/zh/best-practices/nix-path-and-flake-registry.md
View file

@ -21,8 +21,11 @@ Flake Registry 是一个 Flake 注册中心，它可以帮助我们在使用 `ni
## 自定义 NIX_PATH 与 Flake Registry {#custom-nix-path-and-flake-registry-2} ## 自定义 NIX_PATH 与 Flake Registry {#custom-nix-path-and-flake-registry-2}
> **注意：新手请先跳过这部分内容！因为配置如果抄得不对，关掉 nix-channel 可能会导致一些令人头疼的错误。**
前面说明了 `NIX_PATH` 与 Flake Registry 的作用。 前面说明了 `NIX_PATH` 与 Flake Registry 的作用。
在日常使用中，我们一般都会希望能在执行 `nix repl '<nixpkgs>'`, `nix run nixpkgs#ponysay hello` 等命令时，使用的 nixpkgs 与系统一致，这就需要我们自定义 `NIX_PATH` 与 Flake Registry。 在日常使用中，我们一般都会希望能在执行 `nix repl '<nixpkgs>'`, `nix run nixpkgs#ponysay hello` 等命令时，使用的 nixpkgs 与系统一致，这就需要我们自定义 `NIX_PATH` 与 Flake Registry。
另外 `nix-channel` 虽然也能与 flakes 特性共存，但实际上 flakes 已经能够完全替代它了，所以我们也可以将其关闭。
在你的 NixOS 配置中，添加如下 module 即可实现上述需求： 在你的 NixOS 配置中，添加如下 module 即可实现上述需求：