Aplica a: Cloud Server con Supabase instalado · Tiempo estimado: lectura
Qué es Supabase
Supabase es una plataforma open source que provee herramientas backend listas para usar, construidas sobre PostgreSQL. Es una alternativa moderna a Firebase que mantiene la flexibilidad de una base de datos relacional estándar — en lugar de abstraer la base de datos, la expone directamente como núcleo del producto.
Documentación oficial: supabase.com/docs/guides/getting-started
Antes de empezar
La versión self-hosted de Supabase tiene diferencias importantes respecto a Supabase Cloud:
No es multi-tenant — cada instalación corresponde a un único proyecto
Las pantallas Storage → Files → Settings y Databases → Settings → Connection pooling son exclusivas de Supabase Cloud y no funcionan en la versión self-hosted
Muchas configuraciones se realizan mediante el archivo
.envy no desde la interfaz gráfica
Qué incluye
Base de datos PostgreSQL — PostgreSQL completo con extensiones nativas (uuid, pgcrypto, full-text search, vector), migraciones, seeds y Row Level Security (RLS).
API automática — API REST generada automáticamente a partir del esquema de la base, API en tiempo real (Realtime) para cambios en tablas, con soporte para filtros, ordenamientos y paginación.
Autenticación — registro e inicio de sesión con email/password, magic links y OAuth (Google, GitHub, etc.), gestión de sesiones y tokens JWT.
Storage — almacenamiento de archivos (imágenes, documentos, videos), control de acceso integrado con Auth y RLS, buckets públicos y privados.
Edge Functions — funciones serverless escritas en JavaScript o TypeScript, ejecutadas cerca del usuario.
Realtime — suscripciones a cambios en la base de datos, ideal para chats, dashboards en vivo y notificaciones.
Arquitectura
Supabase está construido sobre una arquitectura modular centrada en PostgreSQL como fuente de verdad: PostgREST para la API REST, GoTrue para autenticación, Storage API para archivos, Realtime para eventos y Edge Functions para lógica personalizada. Todo gira alrededor de PostgreSQL, evitando el lock-in propietario.
Casos de uso comunes
AI, vectores y embeddings — búsquedas semánticas e integración con modelos de IA usando PostgreSQL + extensiones vectoriales
Aplicaciones SaaS — manejo de usuarios, roles, permisos e integración con pagos
Aplicaciones web y móviles — CRUDs, dashboards, sistemas de gestión y apps en tiempo real
Frameworks compatibles
Supabase ofrece guías oficiales para React, Next.js, Nuxt, Vue, Svelte/SvelteKit, SolidJS, Angular, Flutter, Expo React Native, iOS (Swift) y Android (Kotlin), entre otros. Las guías explican cómo crear un proyecto, agregar datos de ejemplo, autenticar usuarios y consultar la base desde la aplicación.
