Docs: supabase db pull requires Docker daemon running, but the docs don’t mention it

[magentaqin]

Link https://supabase.com/docs/reference/cli/supabase-db-pull

Describe the problem The documentation for supabase db pull does not mention that the Docker daemon must be running before executing this command.

On a fresh setup, running:

supabase db pull

results in the following error:

failed to inspect docker image: Cannot connect to the Docker daemon at
unix:///Users/.../docker.sock. Is the docker daemon running?

The underlying reason is that db pull internally spins up a local Postgres container to diff the remote schema — which requires Docker Desktop (or any running Docker daemon).

Because the docs do not specify this prerequisite, new users may be confused or think something is wrong with their setup.

Describe the improvement I would suggest you add a note in the db pull documentation, similar to the supabase start section, for example:

This command requires Docker Desktop (or a running Docker daemon), as it creates a local Postgres instance to diff your remote database schema.

Additional context

[sweatybridge]

The docs for this command lives here https://github.com/supabase/cli/blob/develop/docs/supabase/db/pull.md if you want to update it. It will be published to main supabase repo on next stable release (in 2 weeks time).

Thanks again for taking the initiative.

[magentaqin]

The docs for this command lives here https://github.com/supabase/cli/blob/develop/docs/supabase/db/pull.md if you want to update it. It will be published to main supabase repo on next stable release (in 2 weeks time).

Thanks again for taking the initiative.

Sure!