diff --git a/docs/best-practices/nix-path-and-flake-registry.md b/docs/best-practices/nix-path-and-flake-registry.md
index 418f84d..70a0ba4 100644
--- a/docs/best-practices/nix-path-and-flake-registry.md
+++ b/docs/best-practices/nix-path-and-flake-registry.md
@@ -29,6 +29,7 @@ In your NixOS configuration, adding the following module will achieve the mentio
 {
   # Make `nix run nixpkgs#nixpkgs` use the same nixpkgs as the one used by this flake.
   nix.registry.nixpkgs.flake = nixpkgs;
+  nix.channel.enable = false;  # disable nix-channel, we use flakes instead.
 
   # Make `nix repl '<nixpkgs>'` use the same nixpkgs as the one used by this flake.
   environment.etc."nix/inputs/nixpkgs".source = "${nixpkgs}";
diff --git a/docs/zh/best-practices/nix-path-and-flake-registry.md b/docs/zh/best-practices/nix-path-and-flake-registry.md
index 59ebcf9..83b71d4 100644
--- a/docs/zh/best-practices/nix-path-and-flake-registry.md
+++ b/docs/zh/best-practices/nix-path-and-flake-registry.md
@@ -30,6 +30,7 @@ Flake Registry 是一个 Flake 注册中心，它可以帮助我们在使用 `ni
 {
   # make `nix run nixpkgs#nixpkgs` use the same nixpkgs as the one used by this flake.
   nix.registry.nixpkgs.flake = nixpkgs;
+  nix.channel.enable = false;  # disable nix-channel, we use flakes instead.
 
   # make `nix repl '<nixpkgs>'` use the same nixpkgs as the one used by this flake.
   environment.etc."nix/inputs/nixpkgs".source = "${nixpkgs}";