diff --git a/apps/docs/content/guides/local-development.mdx b/apps/docs/content/guides/local-development.mdx index 429263fef7e..88ab7d489f5 100644 --- a/apps/docs/content/guides/local-development.mdx +++ b/apps/docs/content/guides/local-development.mdx @@ -9,10 +9,10 @@ To develop your applications using the locally running Supabase stack, you'll ne A container manager compatible with Docker APIs is a prerequisite: -- [Docker Desktop](https://docs.docker.com/desktop/) (macOS, Windows, Linux) - preferred option +- [OrbStack](https://orbstack.dev/) (macOS) - recommended on macOS +- [Docker Desktop](https://docs.docker.com/desktop/) (macOS, Windows, Linux) - recommended on Windows and Linux - [Rancher Desktop](https://rancherdesktop.io/) (macOS, Windows, Linux) - [Podman](https://podman.io/) (macOS, Windows, Linux) -- [OrbStack](https://orbstack.dev/) (macOS) diff --git a/apps/docs/content/guides/local-development/cli/getting-started.mdx b/apps/docs/content/guides/local-development/cli/getting-started.mdx index bb3b250f74b..9f4e581b586 100644 --- a/apps/docs/content/guides/local-development/cli/getting-started.mdx +++ b/apps/docs/content/guides/local-development/cli/getting-started.mdx @@ -247,13 +247,14 @@ supabase stop --no-backup ## Running a local Supabase project -The most common thing you'll do with the CLI is run the full Supabase stack (Postgres, Auth, Storage, and the rest) on your own machine. That stack runs in Docker containers, so you need a container runtime installed first. Follow the official guide to install and configure [Docker Desktop](https://docs.docker.com/desktop) on your machine. +The most common thing you'll do with the CLI is run the full Supabase stack (Postgres, Auth, Storage, and the rest) on your own machine. That stack runs in Docker containers, so you need a container runtime installed first. On Windows and Linux, follow the official guide to install and configure [Docker Desktop](https://docs.docker.com/desktop). + +On macOS, we recommend [OrbStack](https://orbstack.dev/) instead of Docker Desktop. It's a drop-in replacement that handles extended file attributes (xattrs) on mounted volumes and container networking more reliably than Docker Desktop. It also starts faster and uses less CPU, memory, and disk, which makes a noticeable difference when running the full Supabase stack. Alternately, you can use a different container tool that offers Docker compatible APIs. - [Rancher Desktop](https://rancherdesktop.io/) (macOS, Windows, Linux) - [Podman](https://podman.io/) (macOS, Windows, Linux) -- [OrbStack](https://orbstack.dev/) (macOS) - [colima](https://github.com/abiosoft/colima) (macOS) With a container runtime running, go to the folder where you want to create your project and initialize it: