Supabase
Supabase regroupe une base de données PostgreSQL avec un service Auth, une API REST, une API GraphQL, des souscriptions Realtime et un service de stockage de fichiers derrière un seul point d'accès. Studio, la console web de Supabase, est disponible mais désactivée par défaut car elle dispose d'un accès complet à la base de données. Certaines fonctionnalités de Supabase ne sont pas proposées ; voir Non proposé. La disponibilité dépend de l'infrastructure du projet ; les organisations en période d'essai ne peuvent pas créer d'instance Supabase.
Créer une instance
Ouvrez Services → Create Service → Supabase. Le formulaire de création comporte ces sections :
- Basic Configuration — nom de l'instance et version PostgreSQL de Supabase.
- Resources — classe de calcul de la base de données (
eco,standardouproduction) et flavor (vCPU et mémoire), taille de stockage de la base de données, et taille de stockage de fichiers pour l'API Storage. Les tailles ne peuvent qu'augmenter. Auth, REST, GraphQL, Realtime, Storage et la passerelle API s'exécutent avec une empreinte fixe de 1 350 mCPU et 1 152 Mio de mémoire (Auth 500 mCPU, REST, Realtime et Storage 250 mCPU chacun, la passerelle API 100 mCPU), facturée aux tarifs de la classe de calcul choisie, en plus du prix de la base de données. Ces quantités de CPU sont des plafonds : un trafic intense est ralenti, pas absorbé par davantage de ressources. Comme tout pod de base de données, chaque composant réserve exactement ce qui lui est facturé. Activer Studio ajoute Studio et le service de métadonnées de la base (350 mCPU et 544 Mio, aux mêmes tarifs) ainsi qu'un volume de 1 Gio sur la classe de stockage de l'instance. Les prix suivent les tarifs de votre organisation. Le résumé des ressources détaille la base de données, les composants, Studio lorsqu'il est activé, les volumes et une estimation du stockage des sauvegardes, de sorte que le coût total soit visible avant de créer l'instance ; le montant horaire affiché est celui qui est facturé. - API access — accès public HTTPS à l'API, activé par défaut car les bibliothèques clientes de Supabase l'appellent directement depuis les navigateurs et les applications mobiles, avec une liste d'autorisation d'IP optionnelle.
- Studio — la console web, désactivée par défaut.
- Authentication — paramètres Auth optionnels ; voir Authentification.
- Backups — configuration des snapshots planifiés, activée par défaut avec une exécution quotidienne à 02:00 UTC. Le planning peut être modifié ; les snapshots manuels restent disponibles quel que soit ce paramètre.
Ce qui est inclus
- Database — une base de données PostgreSQL 17, dimensionnée selon le flavor choisi. L'image embarque des extensions comme pg_cron, pgmq, pgvector, PostGIS, wrappers, Vault et pg_net (utilisée par les webhooks de base de données) ; activez-en une avec
CREATE EXTENSIONou depuis Studio. - Auth — inscription, connexion et gestion des sessions utilisateur par e-mail et mot de passe ou via des fournisseurs OAuth, et authentification multifacteur par application TOTP. Voir Authentification.
- REST — une API REST générée automatiquement à partir du schéma de la base, appliquant la sécurité au niveau des lignes (row-level security).
- GraphQL — une API GraphQL sur ce même schéma.
- Realtime — des souscriptions aux modifications de la base via WebSocket.
- Storage — une API de stockage de fichiers de type S3, adossée à son propre volume, également accessible via un point d'accès compatible S3. Un envoi est limité à 50 Mio par défaut ; la limite peut être relevée jusqu'à 5 Gio (
fileStorage.maxFileSizeMiBdans l'API). - Studio — la console web de Supabase. Désactivée par défaut. Lorsqu'elle est activée, elle est servie sur le même point d'accès public derrière son propre nom d'utilisateur et mot de passe, et dispose d'un accès complet à la base de données — ne l'activez que pour des opérateurs de confiance. Studio et le service de métadonnées de la base dont il dépend ne s'exécutent, et ne sont facturés, que tant que Studio est activé. Désactiver Studio les supprime avec le volume de Studio : les extraits SQL enregistrés dans Studio sont perdus, et le réactiver démarre un Studio vide.
Non proposé
- Les transformations d'images (imgproxy).
- Un pooler de connexions (Supavisor).
- L'accès public à la base de données. La base n'est accessible que depuis le projet : depuis les conteneurs et les jobs via
DATABASE_URL, ou depuis l'éditeur SQL de Studio. - Les domaines personnalisés.
- La connexion par téléphone et SMS, l'authentification unique SAML, les hooks d'authentification, les CAPTCHA, les modèles d'e-mails personnalisés et les connexions anonymes.
- L'assistant IA et l'explorateur de logs de Studio.
- Les Edge Functions — exécutez votre logique personnalisée dans un conteneur ou un job.
- Les outils d'analyse propres à Supabase — utilisez les logs, métriques et alertes de SailOps.
Authentification
Les paramètres Auth sont optionnels. Renseignez-les dans la section Authentication du formulaire, ou via l'objet auth de l'API ; ils peuvent être modifiés après la création. Modifier un paramètre redémarre Auth, et l'instance affiche Updating jusqu'à ce qu'il soit de nouveau prêt.
- Site URL — l'adresse HTTPS de votre application, utilisée comme redirection par défaut après la connexion et dans les e-mails. Par défaut, le point d'accès public de l'instance.
- Redirect URLs — jusqu'à 20 URL supplémentaires vers lesquelles une connexion peut rediriger. Les motifs comme
https://*.example.com/**sont acceptés. - Disable sign-ups — refuse les nouveaux comptes ; les utilisateurs existants peuvent toujours se connecter. Activé par défaut : sinon, n'importe qui détenant la clé publishable pourrait créer un compte, confirmé immédiatement tant qu'aucun serveur SMTP n'est configuré.
- SMTP — hôte, port (587 par défaut), nom d'utilisateur, mot de passe, adresse et nom d'expéditeur du serveur de messagerie par lequel Auth envoie ses e-mails.
- Fournisseurs OAuth — un identifiant client et un secret client par fournisseur : Google, GitHub, GitLab, Bitbucket, Discord, Facebook, Apple, LinkedIn (OIDC), Slack (OIDC), Twitch, Spotify, Notion, Zoom, X et Figma.
Tant qu'aucun serveur SMTP n'est configuré, Auth n'envoie aucun e-mail : ni confirmation, ni réinitialisation de mot de passe, ni lien magique, ni invitation. Les nouveaux comptes par e-mail sont confirmés automatiquement. Une fois SMTP configuré, les nouveaux comptes doivent confirmer leur adresse.
Pour un fournisseur OAuth, enregistrez <point d'accès public>/auth/v1/callback comme URI de redirection dans la console du fournisseur. Le fournisseur renvoie le navigateur des utilisateurs vers cette URL : la connexion OAuth nécessite donc l'accès public. Les fournisseurs qui demandent aussi leur propre URL de serveur, comme Azure, Keycloak et WorkOS, ne sont pas proposés.
Le mot de passe SMTP et les secrets des fournisseurs sont en écriture seule : ils ne sont jamais renvoyés, seule leur présence l'est. Une mise à jour qui omet un secret conserve celui enregistré. Un mot de passe SMTP vide supprime celui enregistré ; le secret d'un fournisseur se supprime en retirant le fournisseur. Une instance restaurée conserve les paramètres Auth de la source, secrets compris, mais elle a un nouveau nom d'hôte : enregistrez son <endpoint public>/auth/v1/callback auprès de chaque fournisseur OAuth.
Point d'accès public
L'accès public est activé par défaut. Lorsqu'il est activé, seuls les chemins de l'API sont exposés sur le point d'accès public : Auth, REST, GraphQL, Realtime et Storage. Studio et l'API interne de métadonnées ne sont jamais accessibles via le point d'accès public, sauf si Studio est explicitement activé, auquel cas ils sont servis sur le même nom d'hôte derrière les identifiants propres à Studio. Une liste d'autorisation CIDR optionnelle restreint les adresses clientes pouvant atteindre le point d'accès public ; une liste vide autorise toutes les adresses.
REST, GraphQL, Realtime et l'API Auth exigent une clé API. Storage applique ses propres règles d'accès : les fichiers des buckets publics et les URL signées sont lisibles sans clé. Les chemins Auth qu'un navigateur ouvre directement (/auth/v1/verify, /auth/v1/callback, /auth/v1/authorize), /.well-known/* et /sso/saml/* sont ouverts par conception.
Identifiants
L'onglet Credentials et l'API des identifiants renvoient toujours :
- le point d'accès de l'API, la clé publiable (« publishable », sûre à distribuer aux navigateurs ; soumise à la sécurité au niveau des lignes) et la clé secrète (contourne la sécurité au niveau des lignes, réservée au code serveur), ainsi que leurs équivalents JWT historiques, la clé anon et la clé service role, pour les clients antérieurs aux nouvelles clés ;
- l'hôte, le port (5432), le nom (
postgres) et l'utilisateur (postgres) de la base de données, accessible uniquement depuis le projet ; - le point d'accès S3 de l'API Storage (
<point d'accès>/storage/v1/s3), la région, l'identifiant de clé d'accès et la clé d'accès secrète. Ces clés S3 donnent un accès complet à tous les buckets ; gardez-les côté serveur.
Le mot de passe Studio et le mot de passe de la base de données ne sont chacun affichés qu'une seule fois, lors de la première lecture des identifiants après la création de l'instance ou après une réinitialisation. Une lecture ultérieure renvoie tout sauf ces deux mots de passe.
Réinitialiser les identifiants régénère le mot de passe Studio et le mot de passe de la base de données et les renvoie une seule fois ; cela ne fait jamais tourner les clés API, car leur rotation casserait immédiatement tous les clients déjà connectés. Pendant une réinitialisation, l'instance redémarre ses composants pour prendre en compte le nouveau mot de passe, ce qui prend environ une à deux minutes ; l'instance affiche Updating pendant cette fenêtre.
Connecter des conteneurs et des jobs
Créez une connexion depuis un conteneur ou un job et sélectionnez l'instance Supabase. Le niveau d'accès choisi pour la connexion contrôle les identifiants injectés :
- Lecture seule — le point d'accès de l'API et la clé publiable, suffisant pour un client qui appelle uniquement les API REST, GraphQL ou Realtime sous la sécurité au niveau des lignes.
- Lecture/écriture et complet — les mêmes, plus la clé secrète et une chaîne de connexion PostgreSQL directe, pour du code côté serveur qui doit contourner la sécurité au niveau des lignes ou interroger directement la base de données.
Sauvegardes et restauration
Les sauvegardes planifiées prennent un snapshot du volume de la base de données et du volume de stockage de fichiers ensemble, quotidiennement à 02:00 UTC par défaut ; le planning est configurable et peut être désactivé, les snapshots manuels restant alors disponibles. Les sauvegardes planifiées sont conservées sept jours ; les sauvegardes manuelles sont conservées jusqu'à leur suppression.
Les sauvegardes sont facturées comme stockage de sauvegarde, sur la taille des volumes qu'elles contiennent. Les sauvegardes planifiées sont conservées sept jours : le résumé des ressources compte donc les exécutions que le planning produit en sept jours (au moins une), plus une sauvegarde manuelle, soit huit avec le planning quotidien par défaut. Il estime le stockage des sauvegardes à ce nombre × (stockage de la base + stockage de fichiers) × le prix du stockage de sauvegarde par Gio et par mois. Il s'agit d'une estimation : la facture suit les sauvegardes qui existent réellement. Une sauvegarde purgée ou supprimée cesse d'être facturée.
Restaurer une sauvegarde crée toujours une nouvelle instance plutôt que d'écraser la source. L'instance restaurée conserve les clés API et les paramètres Auth de l'instance source, de sorte que les applications déjà configurées avec ces clés continuent de fonctionner contre l'instance restaurée sans aucune modification de code. Les champs non renseignés dans une demande de restauration héritent de la configuration de l'instance source, et les tailles ne peuvent être qu'égales ou supérieures à celles de la source — jamais inférieures.
Redimensionnement
Les volumes de la base de données et du stockage de fichiers ne peuvent qu'augmenter, jamais diminuer. La classe de stockage choisie à la création est fixée pour toute la durée de vie de l'instance. La classe de calcul et le flavor de la base de données peuvent être modifiés après la création.
Suspension
Lorsqu'un projet est suspendu, le calcul de l'instance Supabase n'est plus facturé et son point d'accès public est fermé, mais la base de données sous-jacente continue de fonctionner afin que la plateforme puisse la reprendre de manière fiable. Le stockage reste facturé pendant la suspension. La reprise du projet restaure l'accès public une fois que chaque composant est de nouveau prêt.
Logs, métriques et alertes
L'onglet Logs filtre par composant (base de données, Auth, REST, Realtime, Storage, passerelle API, ainsi que service de métadonnées et Studio tant que Studio est activé). L'onglet Observability affiche l'utilisation CPU, mémoire et stockage dans le temps, avec le même tableau de bord que les autres services. Les alertes sont levées au niveau du pod pour l'instance, de la même façon que pour les autres bases de données managées.
Limites
- Une seule base de données par instance — Supabase ne propose pas de récupération à un instant précis (point-in-time recovery) ; seules les sauvegardes planifiées et manuelles ci-dessus sont disponibles.
- Supprimer une instance supprime sa base de données et ses fichiers stockés. Ses sauvegardes ne sont pas supprimées avec elle ; elles restent disponibles pour une restauration vers une nouvelle instance jusqu'à ce que vous les supprimiez explicitement.
- Les organisations en période d'essai ne peuvent pas créer d'instance Supabase.