Tu choisis les services que nous pouvons activer pour l’analyse, la personnalisation et les contenus externes.
Nous utilisons des cookies et des technologies similaires sur notre site pour personnaliser les contenus, intégrer des médias externes et mieux comprendre l’utilisation de certaines sections.
Cookies nécessaires
Ces entrées assurent des fonctions essentielles comme la sécurité, la stabilité et le traitement des formulaires.
Tes données peuvent être traitées avec ton consentement ou sur la base d’intérêts légitimes. Dans les paramètres des cookies, tu peux refuser chaque catégorie facultative ou l’autoriser individuellement.
Certains services traitent des données personnelles dans des pays tiers. En donnant ton consentement, tu acceptes également ce transfert. Pour en savoir plus, consulte notre politique de confidentialité.
Tu pourras rouvrir et modifier ta sélection à tout moment. · 1.0.2
Configure Supabase sur un serveur Windows : installe WSL2 avec Ubuntu, configure Docker, démarre Supabase et rends-le accessible depuis l’extérieur → En savoir plus
10 novembre 20266 min de lecture4 Vues0 utile
Introduction
Supabase est une plateforme de développement Postgres open source qui fournit une base de données Postgres complète, ainsi que l’authentification, des API instantanées, des fonctionnalités en temps réel et du stockage : une alternative open source à Firebase.
Supabase se compose de plusieurs conteneurs Linux. Sur un serveur Windows, ces conteneurs ne fonctionnent pas directement, mais dans un système Linux que tu configures avec le Sous-système Windows pour Linux (WSL2). Dans ce guide, nous te montrons comment installer WSL2 avec Ubuntu, configurer Docker dans cet environnement et démarrer Supabase.
Conseil
C’est plus simple avec un Serveur VPS Linux
Sur un Serveur VPS Linux (Debian ou Ubuntu), tu peux installer Supabase en quelques clics avec les Applications en un clic dans l’interface Web de ton Serveur VPS, ou manuellement en suivant notre guide Configurer Supabase sur un serveur Linux. C’est la méthode que nous recommandons : sous Windows, WSL2 exécute également une machine virtuelle distincte dans ton Serveur VPS, qui utilise de la mémoire vive et du processeur et demande davantage de maintenance. Les applications en un clic ne sont pas disponibles sur les Serveurs VPS Windows.
Prérequis
Avant d’installer Supabase, vérifie que ton environnement d’hébergement répond aux exigences suivantes. Windows et l’environnement WSL2 ont besoin de ressources supplémentaires en plus de celles utilisées par Supabase.
Matériel
Minimum
Recommandation ZAP-Hosting
CPU
2 cœurs vCPU
4 cœurs vCPU
RAM
8 Go
16 Go
Espace disque
60 Go
80 Go
Système d’exploitation : Windows Server 2022 ou Windows Server 2025
Dépendances :WSL2 avec Ubuntu 24.04, ainsi que Git et Docker (Engine et Compose) dans cet environnement
Attention
Pas de Docker Desktop ni de conteneurs Windows
Docker Desktop n’est pas pris en charge par Docker sur Windows Server. Le moteur Docker de notre guide Configurer Docker sur un serveur Windows exécute uniquement des conteneurs Windows et ne convient donc pas à Supabase. Installe Docker dans Ubuntu sur WSL2, comme décrit ci-dessous.
FAQ
Questions fréquentes
Supabase fonctionne dans des conteneurs Linux. Sur Windows Server 2022 ou 2025, commence par installer WSL2 avec Ubuntu, configure Docker Engine et Docker Compose dans cet environnement, puis démarre Supabase avec docker compose. Les applications en un clic sont uniquement disponibles sur les Serveurs VPS Linux.
Supabase est une plateforme de développement Postgres open source qui fournit une base de données Postgres complète, ainsi que l’authentification, des API instantanées, des fonctionnalités en temps réel et du stockage : une alternative open source à Firebase.
Comme Windows et WSL2 ont besoin de ressources supplémentaires, prévois au minimum 2 cœurs vCPU, 8 Go de RAM et 60 Go d’espace disque. ZAP-Hosting recommande 4 cœurs vCPU, 16 Go de RAM et 80 Go d’espace disque.
Non. Docker Desktop n’est pas pris en charge sur Windows Server, et Docker Engine pour Windows exécute uniquement des conteneurs Windows. Installe plutôt Docker dans Ubuntu sur WSL2.
Oui. Sur un Serveur VPS Linux avec Debian ou Ubuntu, tu peux installer Supabase en quelques clics avec les applications en un clic dans l’interface Web du Serveur VPS. C’est la méthode que nous recommandons.
Avis
Cet article t’a-t-il été utile ?
Ton avis nous aide à mieux définir les priorités et à améliorer les contenus.
0 de 0 Les personnes ayant donné leur avis ont trouvé cet article utile.
Aide personnalisée
Le guide ne suffit pas ?
Notre équipe d’assistance ZAP connaît ton produit : décris brièvement ta demande et nous t’aiderons personnellement.
Navigation
Logiciel
Préparation
Installer WSL2 et Ubuntu
Connecte-toi à ton serveur en tant qu’administrateur via le Bureau à distance (RDP). Ouvre PowerShell en tant qu’administrateur et installe WSL2 avec Ubuntu 24.04 :
Code
wsl --install -d Ubuntu-24.04
Redémarre ensuite le serveur. Après le redémarrage, ouvre de nouveau PowerShell et démarre Ubuntu une fois avec wsl -d Ubuntu-24.04. Au premier démarrage, crée un nom d’utilisateur Linux et un mot de passe.
Infos
Le message Nested virtualization is not supported on this machine peut s’afficher au démarrage. Il concerne uniquement les machines virtuelles à l’intérieur de WSL et n’a aucun impact sur Supabase.
Avec wsl -l -v, vérifie qu’Ubuntu est en cours d’exécution et utilise la version 2.
Mettre le système à jour
Exécute toutes les commandes suivantes dans la console Ubuntu (wsl -d Ubuntu-24.04). Commence par mettre les paquets à jour et installer Git :
Quitte la console Ubuntu avec exit, exécute wsl --shutdown dans PowerShell, puis rouvre Ubuntu pour que l’appartenance au groupe soit prise en compte. Vérifie l’installation avec docker version et docker compose version.
Tu trouveras un guide détaillé sur l’utilisation de Docker sous Linux dans notre guide Docker.
Installation
Une fois tous les prérequis remplis, tu peux installer Supabase. Dans la console Ubuntu, télécharge le dépôt Supabase, crée un répertoire pour ton projet et copie-y les fichiers Docker ainsi que le fichier d’environnement d’exemple :
Accède au répertoire du projet, télécharge les images de conteneur les plus récentes et démarre la stack en arrière-plan :
Code
cd supabase-project
docker compose pull
docker compose up -d
Sur le serveur lui-même, tu peux maintenant accéder à Supabase Studio dans ton navigateur à l’adresse http://localhost:8000. Un nom d’utilisateur et un mot de passe te seront demandés. Par défaut, les identifiants sont les suivants :
Nom d’utilisateur : supabase
Mot de passe : this_password_is_insecure_and_should_be_updated
Attention
Identifiants par défaut
Ton application utilise maintenant les identifiants par défaut. Modifie-les comme indiqué dans la section Configuration avant de rendre Supabase accessible depuis l’extérieur.
Rendre Supabase accessible depuis l’extérieur
WSL2 dispose de son propre réseau interne. Pour accéder à Supabase Studio et à l’API via l’adresse IP de ton serveur, transfère le port de Windows vers WSL. Commence par trouver l’adresse IP interne d’Ubuntu dans PowerShell :
Code
wsl -d Ubuntu-24.04 hostname -I
Configure ensuite la redirection et une règle de pare-feu. Remplace [WSL-IP] par la première adresse affichée :
Tu peux maintenant accéder à Supabase Studio à l’adresse http://[deine-ip]:8000.
Infos
L’adresse IP interne de WSL peut changer après un redémarrage. Vérifie-la de nouveau et adapte la redirection avec netsh interface portproxy set v4tov4 listenport=8000 listenaddress=0.0.0.0 connectport=8000 connectaddress=[WSL-IP].
Maintenir Supabase en fonctionnement
WSL arrête Ubuntu dès qu’aucune fenêtre ni commande n’y accède. Pour que Supabase continue de fonctionner, crée sous Windows le fichier C:\Users\<Benutzername>\.wslconfig avec le contenu suivant :
Exécute ensuite wsl --shutdown dans PowerShell, puis redémarre Ubuntu. Les conteneurs Supabase démarreront automatiquement dès que Docker sera lancé dans Ubuntu.
Pour que Supabase démarre également après un redémarrage du serveur, crée une tâche dans le Planificateur de tâches qui s’exécute au démarrage du système sous ton compte administrateur (option Exécuter même si l’utilisateur n’est pas connecté). Comme action, indique wsl.exe avec les arguments -d Ubuntu-24.04 -u root -- systemctl start docker.
Configuration
Ne passe jamais en production avec les valeurs par défaut ou d’exemple. Remplace tous les espaces réservés par des secrets forts et uniques, vérifie que la configuration répond à tes exigences de sécurité et redémarre tous les services pour appliquer les changements.
Génère des clés API sécurisées avant de rendre un service public. Commence par créer un secret JWT de 40 caractères. Tu peux utiliser la valeur fournie ou créer la tienne. Enregistre le secret localement dans un endroit sûr. Ne le partage pas et ne l’ajoute pas à un système de contrôle de version. Utilise ce secret pour générer un JWT, puis dérive les clés API anon et service à l’aide du formulaire de la documentation Supabase : https://supabase.com/docs/guides/self-hosting/docker#generate-api-keys
Exécute deux fois le formulaire pour générer les deux clés. Mets à jour le fichier .env dans le répertoire de ton projet ~/supabase-project avec les valeurs suivantes :
ANON_KEY : clé anon
SERVICE_ROLE_KEY : clé service
Définis les secrets requis dans le même fichier .env. Ces valeurs doivent être définies pour que l’installation fonctionne :
POSTGRES_PASSWORD : mot de passe du rôle postgres
JWT_SECRET : utilisé par PostgREST et GoTrue
SITE_URL : URL de base de ton site
SMTP_* : identifiants de ton serveur de messagerie
POOLER_TENANT_ID : ID de tenant utilisé par le pooler Supavisor
Protège le tableau de bord avec de nouveaux identifiants avant la mise en production. Pour cela, modifie également le fichier .env :
DASHBOARD_USERNAME : nom d’utilisateur du tableau de bord
DASHBOARD_PASSWORD : mot de passe du tableau de bord
Tu peux définir plusieurs utilisateurs du tableau de bord dans volumes/api/kong.yml, dans le répertoire de ton projet :
Pour utiliser toutes les fonctionnalités du tableau de bord en dehors de localhost, définis SUPABASE_PUBLIC_URL dans le fichier .env avec l’URL ou l’adresse IP qui te permettra d’accéder au tableau de bord.
Applique les changements de configuration en redémarrant la stack dans le répertoire de ton projet :
Code
docker compose down
docker compose up -d
Conclusion et ressources complémentaires
Félicitations ! Tu as installé et configuré Supabase sur ton serveur Windows avec WSL2. Nous te recommandons également de consulter ces ressources, qui pourront t’aider à configurer ton serveur :
Tu as des questions spécifiques auxquelles cet article ne répond pas ? Notre équipe est à ta disposition tous les jours pour répondre à tes questions et t’aider : contacte-nous ! 🙂
Hébergement de serveurs dès 2,49 € / mois, mise en ligne immédiate, protection DDoS incluse.
Source préférée sur Google
