diff --git a/docs/guide/installation.md b/docs/guide/installation.md
index 88392f94..a15b7fa5 100644
--- a/docs/guide/installation.md
+++ b/docs/guide/installation.md
@@ -70,9 +70,11 @@ HAPI has three components:
 ## Install the CLI
 
 ```bash
-npm install -g @twsxtd/hapi
+npm install -g @twsxtd/hapi --registry=https://registry.npmjs.org
 ```
 
+> Recommendation: use the official npm registry for global install. Some mirrors may not sync platform packages in time.
+
 Or with Homebrew:
 
 ```bash
diff --git a/docs/guide/quick-start.md b/docs/guide/quick-start.md
index 4018ec6e..62d4cfdd 100644
--- a/docs/guide/quick-start.md
+++ b/docs/guide/quick-start.md
@@ -7,7 +7,7 @@
 ::: code-group
 
 ```bash [npm]
-npm install -g @twsxtd/hapi
+npm install -g @twsxtd/hapi --registry=https://registry.npmjs.org
 ```
 
 ```bash [Homebrew]
@@ -20,6 +20,8 @@ npx @twsxtd/hapi
 
 :::
 
+> Recommendation: use the official npm registry for global install. Some mirrors may not sync platform packages in time.
+
 Other install options: [Installation](./installation.md)
 
 ## Start the hub