Skip to content

Docs: npm global install is unsupported but not documented #4496

Description

@magentaqin

Link
Supabase CLI documentation → Node.js installation tab
https://supabase.com/docs/guides/local-development/cli/getting-started?queryGroups=platform&platform=npm

Describe the problem
The CLI itself throws a clear error when attempting a global npm installation: "Installing Supabase CLI as a global module is not supported."
However, the documentation does not mention that:
• Global installation via npm install -g supabase is no longer supported
• Only npx supabase or installing locally via npm install supabase --save-dev works
• Users are expected to use Homebrew, Scoop, or standalone binaries for global usage

This may confuse users coming from older versions of the CLI, where npm -g supabase was previously supported.

Describe the improvement
Add a clear note in the Node.js tab such as:

“Global installation using npm install -g supabase is not supported.
For global use, please install via Homebrew, Scoop, or the standalone binary.”

Additional context
Image

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions