mirror of
https://github.com/supabase/supabase.git
synced 2026-10-05 09:25:06 +03:00
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:
1 parent
74d634b9d9
commit
fd61ef995f
6 files changed
+7
-64
No files matched your search
@@ -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 |
Reference in new issue
Block a user