The Postgres development platform. Supabase gives you a dedicated Postgres database to build your web, mobile, and AI applications.
TypeScript aialternativeauthdatabasedenoembeddingsexamplefirebasenextjsoauth2pgvectorpostgispostgrespostgresqlpostgrestrealtimesupabasevectorswebsockets
docs: re-publish Multigres Private Alpha docs — merge on October 2, 2026 (#50664)
Nik Richers0405b31b2687
diff --git a/apps/docs/components/ContentListings/ContentListings.client.tsx b/apps/docs/components/ContentListings/ContentListings.client.tsxindex 93086bd588a..b28e1b18841 100644--- a/apps/docs/components/ContentListings/ContentListings.client.tsx+++ b/apps/docs/components/ContentListings/ContentListings.client.tsx@@ -29,6 +29,8 @@ function useContentListingClickHandler(group: ContentListingGroup) {const trackClick = useCallback((item: ContentListingItem) => {+ if (!item.href) return+sendTelemetryEvent({action: 'docs_content_listing_clicked',properties: {@@ -73,8 +75,45 @@ function ContentListingsGroup({ group }: { group: ContentListingGroup }) {)}<ul className={listClassName}>{items.map((item) => {+ const key = `${group.id}-${item.href ?? item.title}`+ const panel = (+ <GlassPanel+ title={item.title}+ icon={resolveContentListingIcon(item.icon)}+ hasLightIcon={item.hasLightIcon ?? typeof item.icon === 'string'}+ className={item.href ? undefined : 'cursor-default'}+ badge={+ item.badge && item.badgePosition !== 'below' ? (+ <Badge variant="success">{item.badge}</Badge>+ ) : undefined+ }+ >+ {item.badge && item.badgePosition === 'below' && (+ <Badge variant="success" className="mb-3 block w-fit">+ {item.badge}+ </Badge>+ )}+ {item.subtitle && (+ <span className="mb-2 block text-tertiary-foreground">{item.subtitle}</span>+ )}+ {item.description}+ </GlassPanel>+ )+ const listContent = (+ <>+ <strong>{item.title}</strong>: {item.description}+ </>+ )++ if (!item.href) {+ return (+ <li key={key} className={gridItemClassName}>+ {isGrid ? panel : listContent}+ </li>+ )+ }+const external = isExternalContentListingHref(item.href)- const key = `${group.id}-${item.href}`if (isGrid) {return (@@ -87,26 +126,7 @@ function ContentListingsGroup({ group }: { group: ContentListingGroup }) {target={external ? '_blank' : undefined}rel={external ? 'noopener noreferrer' : undefined}>- <GlassPanel- title={item.title}- icon={resolveContentListingIcon(item.icon)}- hasLightIcon={item.hasLightIcon ?? typeof item.icon === 'string'}- badge={- item.badge && item.badgePosition !== 'below' ? (- <Badge variant="success">{item.badge}</Badge>- ) : undefined- }- >- {item.badge && item.badgePosition === 'below' && (- <Badge variant="success" className="mb-3 block w-fit">- {item.badge}- </Badge>- )}- {item.subtitle && (- <span className="mb-2 block text-tertiary-foreground">{item.subtitle}</span>- )}- {item.description}- </GlassPanel>+ {panel}</Link></li>)@@ -120,7 +140,7 @@ function ContentListingsGroup({ group }: { group: ContentListingGroup }) {target={external ? '_blank' : undefined}rel={external ? 'noopener noreferrer' : undefined}>- <strong>{item.title}</strong>: {item.description}+ {listContent}</Link></li>)diff --git a/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.ts b/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.tsindex 7898f39f534..17022d54b9b 100644--- a/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.ts+++ b/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.ts@@ -1139,6 +1139,20 @@ export const database: NavMenuConstant = {},],},+ {+ name: 'Multigres',+ url: undefined,+ items: [+ {+ name: 'Overview',+ url: '/guides/database/multigres' as `/${string}`,+ },+ {+ name: 'Compatibility',+ url: '/guides/database/multigres/compatibility' as `/${string}`,+ },+ ],+ },{name: 'Access and security',url: undefined,diff --git a/apps/docs/content/guides/database/multigres.mdx b/apps/docs/content/guides/database/multigres.mdxnew file mode 100644index 00000000000..3100f911fbf--- /dev/null+++ b/apps/docs/content/guides/database/multigres.mdx@@ -0,0 +1,60 @@+---+id: 'multigres'+title: 'Multigres'+subtitle: 'Horizontally scalable Postgres for high availability'+description: 'Run high availability Postgres across multiple nodes with automatic failover, using Multigres.'+---++<Admonition type="caution">++Multigres is in [Private Alpha](/docs/guides/getting-started/features#feature-status). It's free during the Alpha for organizations on a paid plan, for up to two projects, but pricing may change once it leaves Alpha. It isn't covered by the [uptime SLA](/sla), and Supabase isn't targeting production or mission-critical workloads with it during this stage.++</Admonition>++Multigres gives your project high availability by running Postgres across multiple nodes instead of one, so reads and writes continue if a node fails. It is Supabase's integration of [Multigres](https://multigres.com), an open-source project that brings the same distributed-systems approach Vitess brought to MySQL to Postgres.++<ContentListings id="database-multigres-what-you-get" />++## Eligibility++During the Private Alpha:++- Multigres is available to organizations on a paid plan. It isn't available on the Free plan.+- Availability is being rolled out gradually, so the option to enable it may not yet appear for every eligible organization.+- Up to two projects per eligible organization can use Multigres for free during the Alpha.++## Enabling Multigres++In the Dashboard, Multigres appears as **High availability** during project creation:++1. Open [Create a new project](/dashboard/new/_) in the Dashboard.+2. Under **High availability**, turn on **Enable high availability**.+3. Finish the remaining fields such as database password, region, and compute size, if shown.+4. Click **Create new project**.++If your organization isn't eligible or hasn't been rolled out yet, **High availability** won't appear.++## What's not included in the alpha++Some Supabase features and project operations aren't yet available on Multigres-backed projects:++- **Realtime.** Multigres doesn't yet support the logical replication that Realtime depends on, so Realtime is unavailable.+- **Point-in-Time Recovery.** Only the standard daily backups are available.+- **Cross-region read replicas.** Multigres projects run in a single region during the Alpha.+- **OrioleDB.** A project can use Multigres or [OrioleDB](/docs/guides/database/orioledb), not both.+- **Resizing after creation.** Compute size, disk, and the number of replicas can't be changed after a Multigres project is created.+- **Sharding and custom durability policies.** These are on the longer-term roadmap but aren't part of the Alpha.++<Admonition type="caution">++Enabling Multigres migrates your project's database to run on Multigres. There's currently no managed path to move it back to a standard Postgres project.++</Admonition>++## Compatibility++Multigres aims for full compatibility with standard Postgres, but there are some differences to be aware of. See [Multigres compatibility](/docs/guides/database/multigres/compatibility) for details.++## Resources++[Multigres documentation](https://multigres.com/docs) — architecture, self-hosted deployment, and other technical depth that goes beyond the hosted Supabase integration covered on this page.diff --git a/apps/docs/content/guides/database/multigres/compatibility.mdx b/apps/docs/content/guides/database/multigres/compatibility.mdxnew file mode 100644index 00000000000..75f1f1deac3--- /dev/null+++ b/apps/docs/content/guides/database/multigres/compatibility.mdx@@ -0,0 +1,6 @@+---+title: 'Multigres compatibility'+description: 'Where Multigres-backed Postgres projects differ from standard Postgres.'+---++Multigres targets full compatibility with standard Postgres, verified against the [`pg_regress`](https://www.postgresql.org/docs/current/regress.html) test suite. See the [Multigres documentation](https://multigres.com/docs) for lower-level architecture and compatibility details, and the [Multigres overview](/docs/guides/database/multigres#whats-not-included-in-the-alpha) for what's not yet supported during the Private Alpha.diff --git a/apps/docs/content/guides/getting-started/features.mdx b/apps/docs/content/guides/getting-started/features.mdxindex ed3054170aa..77d13dadc2e 100644--- a/apps/docs/content/guides/getting-started/features.mdx+++ b/apps/docs/content/guides/getting-started/features.mdx@@ -199,61 +199,62 @@ Features in Beta are tested by an external penetration tester for security issueIn addition to the Beta requirements, features in GA are covered by the [uptime SLA](/sla).-| Product | Feature | Stage | Available on self-hosted |-| -------------- | -------------------------- | -------------- | ------------------------------------------- |-| Database | Postgres | `GA` | ✅ |-| Database | Vector Database | `GA` | ✅ |-| Database | Auto-generated Rest API | `GA` | ✅ |-| Database | Auto-generated GraphQL API | `GA` | ✅ |-| Database | Webhooks | `beta` | ✅ |-| Database | Vault | `public alpha` | ✅ |-| Database | Supabase Pipelines | `public alpha` | N/A |-| Platform | | `GA` | ✅ |-| Platform | Point-in-Time Recovery | `GA` | 🚧 [wal-g](https://github.com/wal-g/wal-g) |-| Platform | Custom Domains | `GA` | N/A |-| Platform | Network Restrictions | `GA` | N/A |-| Platform | SSL enforcement | `GA` | N/A |-| Platform | Branching | `beta` | N/A |-| Platform | Terraform Provider | `public alpha` | N/A |-| Platform | Read Replicas | `GA` | N/A |-| Platform | Log Drains | `public alpha` | ✅ |-| Platform | MCP | `public alpha` | ✅ |-| Platform | PrivateLink | `beta` | N/A |-| Studio | | `GA` | ✅ |-| Studio | SSO | `GA` | ✅ |-| Studio | Column Privileges | `public alpha` | ✅ |-| Realtime | Postgres Changes | `GA` | ✅ |-| Realtime | Broadcast | `GA` | ✅ |-| Realtime | Presence | `GA` | ✅ |-| Realtime | Broadcast Authorization | `public beta` | ✅ |-| Realtime | Presence Authorization | `public beta` | ✅ |-| Realtime | Broadcast from Database | `public beta` | ✅ |-| Storage | | `GA` | ✅ |-| Storage | CDN | `GA` | 🚧 [Cloudflare](https://www.cloudflare.com) |-| Storage | Smart CDN | `GA` | 🚧 [Cloudflare](https://www.cloudflare.com) |-| Storage | Image Transformations | `GA` | ✅ |-| Storage | Resumable Uploads | `GA` | ✅ |-| Storage | S3 compatibility | `GA` | ✅ |-| Edge Functions | | `GA` | ✅ |-| Edge Functions | Regional Invocations | `GA` | ✅ |-| Edge Functions | NPM compatibility | `GA` | ✅ |-| Auth | | `GA` | ✅ |-| Auth | Email sign-in | `GA` | ✅ |-| Auth | Social login | `GA` | ✅ |-| Auth | Phone sign-in | `GA` | ✅ |-| Auth | Passwordless sign-in | `GA` | ✅ |-| Auth | SSO with SAML | `GA` | ✅ |-| Auth | Authorization via RLS | `GA` | ✅ |-| Auth | CAPTCHA protection | `GA` | ✅ |-| Auth | Server-side Auth | `beta` | ✅ |-| Auth | Third-Party Auth | `GA` | ✅ |-| Auth | Hooks | `beta` | ✅ |-| CLI | | `GA` | ✅ Works with self-hosted |-| Management API | | `GA` | N/A |-| Client Library | JavaScript | `GA` | N/A |-| Client Library | Flutter | `GA` | N/A |-| Client Library | Swift | `GA` | N/A |-| Client Library | Python | `beta` | N/A |+| Product | Feature | Stage | Available on self-hosted |+| -------------- | -------------------------- | --------------- | ------------------------------------------- |+| Database | Postgres | `GA` | ✅ |+| Database | Vector Database | `GA` | ✅ |+| Database | Auto-generated Rest API | `GA` | ✅ |+| Database | Auto-generated GraphQL API | `GA` | ✅ |+| Database | Webhooks | `beta` | ✅ |+| Database | Vault | `public alpha` | ✅ |+| Database | Supabase Pipelines | `public alpha` | N/A |+| Database | Multigres | `private alpha` | N/A |+| Platform | | `GA` | ✅ |+| Platform | Point-in-Time Recovery | `GA` | 🚧 [wal-g](https://github.com/wal-g/wal-g) |+| Platform | Custom Domains | `GA` | N/A |+| Platform | Network Restrictions | `GA` | N/A |+| Platform | SSL enforcement | `GA` | N/A |+| Platform | Branching | `beta` | N/A |+| Platform | Terraform Provider | `public alpha` | N/A |+| Platform | Read Replicas | `GA` | N/A |+| Platform | Log Drains | `public alpha` | ✅ |+| Platform | MCP | `public alpha` | ✅ |+| Platform | PrivateLink | `beta` | N/A |+| Studio | | `GA` | ✅ |+| Studio | SSO | `GA` | ✅ |+| Studio | Column Privileges | `public alpha` | ✅ |+| Realtime | Postgres Changes | `GA` | ✅ |+| Realtime | Broadcast | `GA` | ✅ |+| Realtime | Presence | `GA` | ✅ |+| Realtime | Broadcast Authorization | `public beta` | ✅ |+| Realtime | Presence Authorization | `public beta` | ✅ |+| Realtime | Broadcast from Database | `public beta` | ✅ |+| Storage | | `GA` | ✅ |+| Storage | CDN | `GA` | 🚧 [Cloudflare](https://www.cloudflare.com) |+| Storage | Smart CDN | `GA` | 🚧 [Cloudflare](https://www.cloudflare.com) |+| Storage | Image Transformations | `GA` | ✅ |+| Storage | Resumable Uploads | `GA` | ✅ |+| Storage | S3 compatibility | `GA` | ✅ |+| Edge Functions | | `GA` | ✅ |+| Edge Functions | Regional Invocations | `GA` | ✅ |+| Edge Functions | NPM compatibility | `GA` | ✅ |+| Auth | | `GA` | ✅ |+| Auth | Email sign-in | `GA` | ✅ |+| Auth | Social login | `GA` | ✅ |+| Auth | Phone sign-in | `GA` | ✅ |+| Auth | Passwordless sign-in | `GA` | ✅ |+| Auth | SSO with SAML | `GA` | ✅ |+| Auth | Authorization via RLS | `GA` | ✅ |+| Auth | CAPTCHA protection | `GA` | ✅ |+| Auth | Server-side Auth | `beta` | ✅ |+| Auth | Third-Party Auth | `GA` | ✅ |+| Auth | Hooks | `beta` | ✅ |+| CLI | | `GA` | ✅ Works with self-hosted |+| Management API | | `GA` | N/A |+| Client Library | JavaScript | `GA` | N/A |+| Client Library | Flutter | `GA` | N/A |+| Client Library | Swift | `GA` | N/A |+| Client Library | Python | `beta` | N/A |- ✅ = Fully Available- 🚧 = Available, but requires external tools or configurationdiff --git a/apps/docs/data/content-listings/database.data.ts b/apps/docs/data/content-listings/database.data.tsindex 60c9b4c038e..65cd98428f1 100644--- a/apps/docs/data/content-listings/database.data.ts+++ b/apps/docs/data/content-listings/database.data.ts@@ -94,3 +94,27 @@ export const databaseNextSteps: ContentListingGroup = {},],}++export const databaseMultigresWhatYouGet: ContentListingGroup = {+ id: 'database-multigres-what-you-get',+ heading: 'What you get',+ description:+ 'When you enable Multigres on a project, your database runs as a small cluster instead of a single instance:',+ type: 'grid',+ items: [+ {+ title: 'Automatic failover',+ description:+ 'If a node fails, another in the cluster is promoted within seconds, without you having to intervene.',+ },+ {+ title: 'No connection changes',+ description:+ 'Use the same connection string. Coordination is transparent to your application.',+ },+ {+ title: 'Consensus-backed durability',+ description: 'Writes are acknowledged only after the cluster agrees they are durable.',+ },+ ],+}diff --git a/apps/docs/data/content-listings/index.ts b/apps/docs/data/content-listings/index.tsindex b3aa5c13798..df2d27f335f 100644--- a/apps/docs/data/content-listings/index.ts+++ b/apps/docs/data/content-listings/index.ts@@ -2,7 +2,7 @@ import type { ContentListingGroup } from '~/lib/content-listings.schema'import { aiToolsBuildingIntoApp, aiToolsSupportedAgents } from './ai-tools.data'import { authGetStarted, authNextSteps, authPricing } from './auth.data'-import { databaseGetStarted, databaseNextSteps } from './database.data'+import { databaseGetStarted, databaseMultigresWhatYouGet, databaseNextSteps } from './database.data'import {functionsExamplesAiMedia,functionsExamplesMessaging,@@ -47,6 +47,7 @@ const ALL_GROUPS: readonly ContentListingGroup[] = [authPricing,authNextSteps,databaseGetStarted,+ databaseMultigresWhatYouGet,databaseNextSteps,functionsGetStarted,functionsExamplesSupabase,diff --git a/apps/docs/internals/markdown-schema/ContentListings.ts b/apps/docs/internals/markdown-schema/ContentListings.tsindex 6817ce1f919..56b1c7ba404 100644--- a/apps/docs/internals/markdown-schema/ContentListings.ts+++ b/apps/docs/internals/markdown-schema/ContentListings.ts@@ -34,6 +34,11 @@ export function serializeContentListingGroupToMarkdown(}for (const item of items) {+ if (!item.href) {+ lines.push(`- **${item.title}:** ${item.description}`)+ continue+ }+const href = isExternalContentListingHref(item.href)? item.href: `${linkBaseUrl}${withDocsBasePath(item.href)}`diff --git a/apps/docs/lib/content-listings.test.ts b/apps/docs/lib/content-listings.test.tsindex cd3166285cf..1eeb4059884 100644--- a/apps/docs/lib/content-listings.test.ts+++ b/apps/docs/lib/content-listings.test.ts@@ -147,6 +147,27 @@ describe('serializeContentListingGroupToMarkdown', () => {)})+ it('renders items without href as unlinked list entries', () => {+ const markdown = serializeContentListingGroupToMarkdown(+ {+ id: 'what-you-get',+ heading: 'What you get',+ items: [+ {+ title: 'Automatic failover',+ description: 'Another node is promoted if a node goes down.',+ },+ ],+ },+ 'https://supabase.com'+ )++ expect(markdown).toContain(+ '- **Automatic failover:** Another node is promoted if a node goes down.'+ )+ expect(markdown).not.toContain('](')+ })+it('omits heading line when heading is not set', () => {const markdown = serializeContentListingGroupToMarkdown({@@ -260,9 +281,11 @@ describe('dashboard content listing hrefs', () => {// Root-relative /dashboard hrefs get the docs basePath and 404; use absolute URLs.it('uses absolute https://supabase.com dashboard URLs', () => {const dashboardLinks = Object.values(CONTENT_LISTINGS).flatMap((group) =>- group.items- .filter((item) => isDashboardHref(item.href))- .map((item) => ({ listingId: group.id, title: item.title, href: item.href }))+ group.items.flatMap((item) =>+ item.href && isDashboardHref(item.href)+ ? [{ listingId: group.id, title: item.title, href: item.href }]+ : []+ ))expect(dashboardLinks.length).toBeGreaterThan(0)@@ -275,6 +298,16 @@ describe('dashboard content listing hrefs', () => {})})+describe('contentListingItemSchema href', () => {+ it('accepts an item without href', () => {+ const result = contentListingItemSchema.safeParse({+ title: 'Automatic failover',+ description: 'Another node is promoted if a node goes down.',+ })+ expect(result.success).toBe(true)+ })+})+describe('contentListingItemSchema icon', () => {const baseItem = {title: 'Datadog',diff --git a/apps/docs/lib/content-listings.zod.mjs b/apps/docs/lib/content-listings.zod.mjsindex decf8220a03..bc9b6de5e2d 100644--- a/apps/docs/lib/content-listings.zod.mjs+++ b/apps/docs/lib/content-listings.zod.mjs@@ -22,7 +22,7 @@ export const contentListingIconSchema = z.union([z.string().min(1), contentListiexport const contentListingItemSchema = z.object({title: z.string().min(1),- href: z.string().min(1),+ href: z.string().min(1).optional(),description: z.string().min(1),/** Shown under the title on grid cards, before the description. */subtitle: z.string().min(1).optional(),diff --git a/apps/docs/style-guide/WORD_LIST.md b/apps/docs/style-guide/WORD_LIST.mdindex ae05cb3ecf6..61470ca93bc 100644--- a/apps/docs/style-guide/WORD_LIST.md+++ b/apps/docs/style-guide/WORD_LIST.md@@ -539,6 +539,10 @@ Write _microservices_, not _micro-services_.Use _might_ for possibility or an uncertain outcome.+### Multigres++Use _Multigres_ for the product name. Don't write _multi-gres_ or _MultiGres_.+### mustUse _must_ or _need to_ for a requirement. Don't use _must_ for a recommendation.diff --git a/apps/studio/components/interfaces/ProjectHome/HighAvailabilityBadge.tsx b/apps/studio/components/interfaces/ProjectHome/HighAvailabilityBadge.tsxindex 15041a5c3c5..b1b45f29756 100644--- a/apps/studio/components/interfaces/ProjectHome/HighAvailabilityBadge.tsx+++ b/apps/studio/components/interfaces/ProjectHome/HighAvailabilityBadge.tsx@@ -37,7 +37,7 @@ export function HighAvailabilityBadge({ size = 'default' }: HighAvailabilityBadgglobally distributed deployments.</p><Link- href={`${DOCS_URL}/guides/deployment/high-availability`}+ href={`${DOCS_URL}/guides/database/multigres`}target="_blank"rel="noopener noreferrer"className="mt-1 inline-flex items-center gap-1 text-xs text-foreground-lighter transition-colors hover:text-foreground"