Installer Supabase en local avec Docker te permet de développer sans connexion internet, d’itérer rapidement sans risquer la production, et de ne consommer aucun quota cloud. C’est le workflow recommandé pour tout projet sérieux.
Avant d’aller plus loin, assure-toi d’avoir lu notre guide complet Supabase pour comprendre l’architecture globale de la plateforme. Si tu hésites encore entre Supabase et Firebase, consulte notre comparatif Supabase vs Firebase 2026.
Avantages du développement local
- Développement hors-ligne : pas besoin d’internet pour coder
- Itérations rapides : migrations et tests sans risque de casser la prod
- Gratuité totale : aucun quota consommé pendant le développement
Prérequis
- Docker Desktop (v20+) installé et en cours d’exécution
- Node.js (v18+) pour la CLI Supabase
- Git pour le versionning de tes migrations
- Au moins 4 Go de RAM disponibles pour Docker
Étape 1 : Installer la CLI Supabase
# Via npm
npm install -g supabase
# Via Homebrew (macOS/Linux)
brew install supabase/tap/supabase
# Vérifier l'installation
supabase --versionÉtape 2 : Initialiser ton projet
mkdir mon-projet && cd mon-projet
supabase initÉtape 3 : Démarrer l’instance locale
supabase startÉtape 4 : Configurer les variables d’environnement
NEXT_PUBLIC_SUPABASE_URL=http://localhost:54321
NEXT_PUBLIC_SUPABASE_ANON_KEY=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
SUPABASE_SERVICE_ROLE_KEY=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...Étape 5 : Accéder à Supabase Studio
Ouvre http://localhost:54323 dans ton navigateur pour accéder au Studio local — identique à la version cloud.
Étape 6 : Créer ta première migration
# Créer une migration vide
supabase migration new create_users_table
# Ou générer automatiquement depuis les changements locaux
supabase db diff --schema public -f create_users_tableCommandes essentielles Docker Supabase
| Commande | Action |
|---|---|
| supabase start | Démarre tous les services |
| supabase stop | Arrête les services (conserve les données) |
| supabase status | Affiche les URLs et statuts |
| supabase db reset | Repart de zéro (seed inclus) |
| supabase db push | Applique les migrations en production |
FAQ : Supabase en local avec Docker
Peut-on utiliser Supabase local sans Docker Desktop ?
Non, Docker est obligatoire. Supabase local repose sur un ensemble de conteneurs (PostgreSQL, GoTrue, PostgREST, etc.).
Les données locales sont-elles persistantes ?
Oui, avec supabase stop, tes données sont conservées. Seul supabase db reset efface tout.
👉 Articles du guide Supabase
Cet article fait partie du Guide Complet Supabase 2026. Retrouvez les autres articles de la série :
- ✅ Supabase : Le Guide Complet 2026
- ✅ Supabase vs Firebase : Comparatif Complet 2026
- 📅 Supabase Pricing — à paraître le 02/06
- 📅 Architecture Supabase — à paraître le 04/06
- 📅 Base de données Supabase — à paraître le 06/06
- 📅 Supabase RLS — à paraître le 08/06
