Supabase Postgres open source : installer et superviser

Supabase Postgres open source : installation Docker d’après la documentation, architecture, supervision en auto-hébergement et limites de la pile.
Supabase Postgres open source : installer et superviser

Supabase Postgres open source : le dépôt supabase/supabase rassemble une plateforme de développement construite autour de PostgreSQL, avec authentification, API automatiques, stockage de fichiers, fonctions et boîte à outils pour vecteurs et IA. Il affichait environ 113 200 étoiles en octobre 2026, sous licence Apache-2.0. Le README la présente comme « la plateforme de développement Postgres » qui construit les fonctions de Firebase avec des outils open source de niveau entreprise.

Pour une équipe produit, c’est un back-end prêt à l’emploi. Pour une équipe d’exploitation, c’est surtout une pile de plusieurs services à héberger et à surveiller si l’on choisit l’auto-hébergement. Cet article présente ce que dit le dépôt, l’installation Docker d’après la documentation, et ce qu’on peut observer, avec une limite importante : l’API de métriques du service hébergé n’existe pas en auto-hébergement.

Les informations viennent du README et de la documentation officielle. span.observer n’a pas installé Supabase : les images ci-dessous viennent du dépôt et de la documentation du projet.

Supabase Postgres open source : ce que dit le dépôt

  • Licence : Apache-2.0 (fichier LICENSE du dépôt). Le README ajoute que le projet utilise des outils sous licence MIT, Apache 2 ou équivalente quand ils existent, et qu’il développe et ouvre les autres lui-même : c’est la description du projet.
  • Fonctions listées : base Postgres hébergée, authentification et autorisation, API générées (REST, GraphQL, abonnements en temps réel), fonctions de base de données et Edge Functions, stockage de fichiers, boîte à outils IA et vecteurs, tableau de bord.
  • Modes d’usage : plateforme hébergée (sans installation), auto-hébergement, ou développement local, selon le README.
  • Clients officiels : JavaScript et TypeScript, Flutter, Swift et Python ; d’autres langages sont maintenus par la communauté.
  • Versions : le dépôt ne publie pas de version sur sa page de releases à la date de lecture ; la documentation d’auto-hébergement cite un tag self-hosted/v0.8.3.
Capture du README de Supabase : tableau de bord d'une fonction Edge avec les courbes de temps d'exécution, le nombre d'invocations et le nombre d'erreurs sur sept jours
Source : github.com

La capture du README montre le tableau de bord (Studio) sur une Edge Function : temps d’exécution, invocations et erreurs. C’est la vue « santé » de base côté application.

Schéma d'architecture du dépôt Supabase : une passerelle Envoy qui route /auth vers GoTrue, /rest vers PostgREST, /realtime vers Realtime, /storage vers Storage, /pg vers pg-meta, /functions vers Functions et /graphql vers pg_graphql, tous reliés à PostgreSQL
Source : github.com

Le schéma d’architecture montre l’essentiel : une passerelle Envoy route chaque chemin vers un service, et tous s’appuient sur PostgreSQL. Le README décrit ces briques : Postgres, Realtime (serveur Elixir qui diffuse les changements de la base par websockets), PostgREST (API REST générée), GoTrue (authentification par JWT), Storage (fichiers sur S3, permissions dans Postgres), pg_graphql et postgres-meta.

Installer Supabase en auto-hébergement avec Docker

Étape 1 — Prérequis

La documentation suppose que vous êtes à l’aise avec l’administration Linux, Git, Docker et Docker Compose. Ressources minimales : 4 Go de RAM, 2 cœurs, 40 Go de SSD ; recommandées : 8 Go ou plus, 4 cœurs ou plus, 80 Go ou plus.

Étape 2 — Démarrage rapide sous Linux

curl -fsSL https://supabase.link/setup.sh | sh
cd supabase-project && \
sh run.sh start

Le script, pris en charge sur Debian, Ubuntu et la famille RHEL, installe les prérequis, récupère la configuration, génère les secrets et les clés et prépare les images. La documentation précise que le lien raccourci pointe vers setup.sh : inspectez-le avant de l’exécuter. sh run.sh secrets affiche les identifiants générés.

Étape 3 — Ou installation manuelle, sur tout système

Commandes de la documentation d'auto-hébergement de Supabase : clonage du dépôt au tag self-hosted/v0.8.3, copie de la configuration Docker, création du fichier .env, docker compose pull, puis scripts de génération de clés
Source : supabase.com

Le fichier .env.example contient des mots de passe d’exemple. La documentation avertit de ne jamais démarrer avec ces valeurs : générez les secrets avec sh utils/generate-keys.sh et sh utils/add-new-auth-keys.sh, puis réglez SUPABASE_PUBLIC_URL, API_EXTERNAL_URL et SITE_URL. La passerelle écoute par défaut sur le port 8000.

Superviser Supabase

Ce que le service hébergé propose

La documentation décrit une API de métriques compatible Prometheus (environ 200 séries Postgres) à brancher sur Grafana ou d’autres outils. Elle précise que cette API est en bêta, que les noms de métriques peuvent évoluer, et qu’elle n’est pas disponible dans les instances auto-hébergées.

En auto-hébergement

La configuration par défaut n’inclut pas Logs et Analytics. La documentation indique qu’on peut activer Logflare (analytique), Vector (collecte de journaux) et le Log Explorer de Studio avec un fichier d’override Docker Compose, au prix de ressources supplémentaires. Pour le reste, vous supervisez une pile Docker classique :

  • Conteneurs et ressources : état, redémarrages et mémoire de chaque service (passerelle, base, authentification, Realtime, Storage…), avec vos outils habituels.
  • PostgreSQL : connexions, verrous, requêtes lentes et réplication, avec un exporteur adapté ; pour le transport des signaux, voir le Collector OpenTelemetry vers Dynatrace.
  • Journaux : si vous les envoyez à une plateforme, gardez l’identifiant de trace sur chaque ligne ; voir les logs OpenTelemetry avec trace ID.

Je n’ai pas trouvé d’export OpenTelemetry natif documenté pour la pile auto-hébergée.

Comment vérifier que ça fonctionne

  • docker compose ps montre tous les services démarrés et sains.
  • Le tableau de bord Studio s’ouvre sur l’adresse de la passerelle, avec le mot de passe généré à l’installation.
  • Une requête sur l’API REST d’une table de test répond, et le journal du conteneur correspondant la montre.

Limites et points ouverts

  • Vous exploitez la pile : sauvegardes, mises à jour, TLS et sécurité du réseau sont à votre charge ; la documentation recommande la plateforme hébergée si ces sujets vous sont nouveaux.
  • Parité partielle : l’API de métriques est absente en auto-hébergement ; vérifiez la liste des fonctions avant de migrer.
  • Secrets par défaut : ne conservez jamais les valeurs de .env.example.
  • Version suivie : sans page de releases, c’est le tag self-hosted/… de la documentation qui sert de repère ; relevez-le à chaque installation.

Bonnes pratiques

  • Épinglez le tag de configuration (self-hosted/vX.Y.Z) et relisez les notes avant de mettre à jour.
  • Ne publiez pas la base sur Internet : passez par la passerelle et un proxy TLS.
  • Relisez la documentation de contrôle d’accès aux données avant d’exposer des tables par l’API.
  • Planifiez des sauvegardes de la base et testez la restauration.
  • Pour une pile IA complète, voir la pile IA open source auto-hébergée et Dify et n8n.

Questions fréquentes

Supabase est-il vraiment un remplaçant de Firebase ?

Le projet se décrit comme construisant les fonctions de Firebase avec des outils open source, mais précise que ce n’est pas une correspondance un pour un : la base est PostgreSQL, pas un magasin de documents.

Peut-on l’utiliser pour des vecteurs et de l’IA ?

Le README liste une boîte à outils IA et vecteurs. Consultez sa documentation pour les extensions et les limites de votre version.

L’auto-hébergement est-il gratuit ?

Le code est sous Apache-2.0 ; le serveur, le stockage et l’exploitation restent à votre charge.

Conclusion

Supabase assemble des briques open source autour de PostgreSQL et offre deux chemins : le service hébergé, ou une pile Docker à exploiter soi-même. Dans le second cas, prévoyez dès le départ la supervision des conteneurs et de la base, car l’API de métriques du service hébergé n’est pas incluse.

span.observer est un blog indépendant de la communauté, non affilié à Dynatrace LLC ni aux projets cités. Les marques citées appartiennent à leurs propriétaires. Les outils évoluent vite : vérifiez les commandes et options dans leur documentation officielle (supabase.com/docs).

Total
0
Shares
Laisser un commentaire

Votre adresse e-mail ne sera pas publiée. Les champs obligatoires sont indiqués avec *

Previous Post
Graphify graphe de connaissances : cartographier un code

Graphify graphe de connaissances : cartographier un code

Next Post
Twenty CRM open source : installer, licence et supervision

Twenty CRM open source : installer, licence et supervision

Related Posts