How to stop Supabase Docker Containers from restarting

supabase, docker, containers, wsl2

Main project image

How to stop Supabase Docker Containers from restarting

When running Supabase in a Docker container locally, you may encounter an issue where the container keeps restarting. This can be frustrating, especially if you’re trying to debug or make changes to your setup across restarts or trying to figure out why you’re other Docker containers are running so damn slow. This recently happened to me, and I found a solution that worked with WSL2.

It simple, the Supabase CLI restarts containers by default.

supabase start

Despite running Docker Desktop and manually stopping the containers, they would restart automatically and continue to run in the background.

The CLI command to stop the Supabase local development stack is:

supabase stop

This command stops all Supabase services, including the database, authentication, and storage services and is an often overlooked behaviour.

Just check that the containers have stopped in the Docker Desktop UI to confirm.