diff --git a/cli/install.mdx b/cli/install.mdx
index e2670db3f..80dee70ba 100644
--- a/cli/install.mdx
+++ b/cli/install.mdx
@@ -123,4 +123,16 @@ For syntax highlighting and code formatting in MDX files, we recommend using the
 
     **Solution**: Ask your IT administrator to add `releases.mintlify.com` to your network allowlist.
   </Accordion>
+  <Accordion title="CLI connects to localhost instead of production when using npx">
+    In versions before 4.0.1125, running `npx mint dev` or other commands from a docs
+    repository could cause the CLI to incorrectly detect itself as a local development
+    build. This made the CLI point to `localhost` URLs instead of the Mintlify production
+    API, resulting in connection errors or unexpected behavior.
+
+    **Solution**: Update to the latest CLI version:
+
+    ```bash
+    npm i -g mint@latest
+    ```
+  </Accordion>
 </AccordionGroup>