docs: Small changes to CLI overview (#46796)

## I have read the
[CONTRIBUTING.md](https://github.com/supabase/supabase/blob/master/CONTRIBUTING.md)
file.

YES

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

* **Documentation**
* Updated CLI installation guidance to recommend “global CLI usage”
phrasing and link to platform-specific installation pages
  * Removed duplicate legacy note in the npm install guidance
* Reworded CLI update guidance to state updates use the “same channels”
* Expanded “Running Supabase locally” walkthrough with clear post-init
steps, start instructions, and clarified credentials output
* Clarified analytics schema wording from “will be stored” to “are
stored”
<!-- end of auto-generated comment: release notes by coderabbit.ai -->
This commit is contained in:
Chris Chinchilla authored and GitHub committed 2026-06-11 09:10:54 +00:00
1 parent 74d634b9d9
commit fd61ef995f
6 files changed
+7 -64

No files matched your search

+1 -1
View File
@@ -6,7 +6,7 @@ subtitle: 'Developing locally using the Supabase CLI.'
sidebar_label: 'Overview'
---
You can use the Supabase CLI to run the entire Supabase stack locally on your machine, by running `supabase init` and then `supabase start`. To install the CLI, see the [installation guide](/docs/guides/cli/getting-started#installing-the-supabase-cli).
You can use the Supabase CLI to run the entire Supabase stack locally on your machine, by running `supabase init` and then `supabase start`. To install the CLI, read [the installation guide](/docs/guides/cli/getting-started#installing-the-supabase-cli).
The Supabase CLI provides tools to develop your project locally, deploy to the Supabase Platform, handle database migrations, and generate types directly from your database schema.
@@ -72,28 +72,12 @@ 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
npm install supabase --save-dev
```
<Admonition type="note">
Global installation using `npm install -g supabase` is not supported. For global CLI usage, install via [Homebrew](/docs/guides/local-development/cli/getting-started?queryGroups=platform&platform=macos), [Scoop](/docs/guides/local-development/cli/getting-started?queryGroups=platform&platform=windows), or the [standalone binary](/docs/guides/local-development/cli/getting-started?queryGroups=platform&platform=linux).
</Admonition>
</TabPanel>
</Tabs>
@@ -157,7 +141,7 @@ npx supabase@beta --help
## Updating the Supabase CLI
When a new [version](https://github.com/supabase/cli/releases) is released, you can update the CLI using the same methods.
When a new [version](https://github.com/supabase/cli/releases) is released, you can update the CLI using the same channels.
<Tabs
scrollable
@@ -248,46 +232,7 @@ supabase stop --no-backup
## Running Supabase locally
The Supabase CLI uses Docker containers to manage the local development stack. Follow the official guide to install and configure [Docker Desktop](https://docs.docker.com/desktop):
<Tabs
scrollable
size="small"
type="underlined"
defaultActiveId="macos"
queryGroup="platform"
>
<TabPanel id="macos" label="macOS">
<Image
alt="Docker settings on Mac: Select Integrated, Virtualization Framework, and osxfs"
src={{
dark: '/docs/img/guides/cli/docker-mac.png',
light: '/docs/img/guides/cli/docker-mac-light.png',
}}
width={2880}
height={1800}
/>
</TabPanel>
<TabPanel id="windows" label="Windows">
<Image
alt="Docker settings on Windows: Select Integrated, Expose Daemon, WSL2, and Add to /etc/hosts file."
src={{
dark: '/docs/img/guides/cli/docker-win.png',
light: '/docs/img/guides/cli/docker-win-light.png',
}}
width={2560}
height={1520}
/>
</TabPanel>
</Tabs>
<Admonition type="note">
The Supabase CLI uses Docker containers to manage the local development stack. Follow the official guide to install and configure [Docker Desktop](https://docs.docker.com/desktop) on your machine.
Alternately, you can use a different container tool that offers Docker compatible APIs.
@@ -296,15 +241,13 @@ Alternately, you can use a different container tool that offers Docker compatibl
- [OrbStack](https://orbstack.dev/) (macOS)
- [colima](https://github.com/abiosoft/colima) (macOS)
</Admonition>
Inside the folder where you want to create your project, run:
```bash
supabase init
```
This will create a new `supabase` folder. It's safe to commit this folder to your version control system.
This creates a new `supabase` folder. It's safe to commit this folder to version control.
Now, to start the Supabase stack, run:
@@ -312,11 +255,11 @@ Now, to start the Supabase stack, run:
supabase start
```
This takes time on your first run because the CLI needs to download the Docker images to your local machine. The CLI includes the entire Supabase toolset, and a few additional images that are useful for local development (like a local SMTP server and a database diff tool).
This takes time on your first run because the CLI needs to download the Docker images to your local machine. The CLI includes the entire Supabase stack, and a few additional images useful for local development (like a local SMTP server and a database diff tool).
## Access your project's services
Once all of the Supabase services are running, you'll see output containing your local Supabase credentials. It should look like this, with urls and keys that you'll use in your local project:
Once all the Supabase services are running, you'll see output containing your local Supabase credentials. It should look like the below, with urls and keys that you use in your local project:
```
Started supabase local development setup.
@@ -427,7 +370,7 @@ For advanced logs analysis using the Logs Explorer, it is advised to use the Big
</Admonition>
All logs will be stored in the local database under the `_analytics` schema.
All logs are stored in the local database under the `_analytics` schema.
</TabPanel>
</Tabs>
Binary file not shown.

Before

Width:  |  Height:  |  Size: 568 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 561 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 271 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 250 KiB