How To run Supabase locally

To run Supabase locally, you don’t “download Supabase” like a normal app.
You run the Supabase local development stack using Docker + Supabase CLI.

Follow this exact step-by-step setup 👇

---

✅ Step 1 — Install Prerequisites

You must have:

1. Install Docker

Download from: https://www.docker.com/products/docker-desktop

Then start Docker Desktop.

Check:

docker --version

---

2. Install Supabase CLI

Using npm (recommended for devs):

npm install -g supabase

Check:

supabase --version

---

✅ Step 2 — Initialize Supabase Project Locally

Go to your project folder:

mkdir my-supabase-app
cd my-supabase-app

Now initialize:

supabase init

This creates:

supabase/
   config.toml

---

✅ Step 3 — Start Local Supabase

Now run:

supabase start

This will:

✅ Pull Docker images
✅ Start local Postgres
✅ Start Auth
✅ Start Storage
✅ Start Realtime
✅ Start Studio

First time = takes few minutes.

---

✅ Step 4 — Open Supabase Studio (Local Dashboard)

After start you will see something like:

Studio URL: http://localhost:54323
API URL: http://localhost:54321
DB URL: postgresql://postgres:postgres@localhost:54322/postgres

Open:

👉 http://localhost:54323

Now you have full Supabase dashboard locally 🎉

---

✅ Step 5 — Stop Supabase

When done:

supabase stop

---

⭐ Very Important (Common Errors)

❌ Docker not running

Fix → Start Docker Desktop

❌ Port already used

Fix → change ports in:

supabase/config.toml

❌ CLI not found

Fix → reinstall globally:

npm i -g supabase

---

🚀 Pro Dev Tip (Next.js Integration)

If you are using Next.js, local .env example:

NEXT_PUBLIC_SUPABASE_URL=http://localhost:54321
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_local_key

You can get keys from:

supabase status