Skip to content

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

@magentaqin

Description

@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

Image

Metadata

Metadata

Assignees

No one assigned

    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