Skip to content

The Postgres development platform. Supabase gives you a dedicated Postgres database to build your web, mobile, and AI applications.

docs: clarify npm global install is unsupported for Supabase CLI (#41886)

Om Wanereb06be0b29656
diff --git a/apps/docs/content/guides/local-development/cli/getting-started.mdx b/apps/docs/content/guides/local-development/cli/getting-started.mdx
index 5cd643b37d6..4d9ab20346c 100644
--- a/apps/docs/content/guides/local-development/cli/getting-started.mdx
+++ b/apps/docs/content/guides/local-development/cli/getting-started.mdx
@@ -72,6 +72,16 @@ The Supabase CLI requires **Node.js 20 or later** when run via `npx` or `npm`. O
</Admonition>
+<Admonition type="note">
+
+Installing the Supabase CLI globally using `npm install -g supabase` is **not supported**.
+
+For global usage, install the CLI via Homebrew, Scoop, or the standalone binary.
+
+Alternatively, you can run the CLI using `npx supabase` or install it locally as a dev dependency.
+
+</Admonition>
+
You can also install the CLI as dev dependency via [npm](https://www.npmjs.com/package/supabase):
```sh