Supabase CLI v3.2.0 — 2026-11-16
This release adds config tooling (config validate and config convert), HTTPS on the local API for the experimental stack backend, and stack prune for cleaning up stacks whose project directories are gone. It also drops Postgres 13 for local databases, which is a breaking change for anyone still on it. Most of the rest is bug fixes.
⚠️ Breaking changes
- Postgres 13 is no longer supported for local databases — the CLI never shipped a Postgres 13 image, so a
db.major_version = 13config already ran Postgres 15. It is now rejected at config validation. Setdb.major_versionto 14, 15 or 17; 17 is the upgrade target. (#7594)
Highlights
supabase config validate— checksconfig.toml,config.jsonorconfig.jsoncon its own and reports every problem in one pass, with file, line and column. It's deterministic in CI becauseenv()values are treated as unknown unless you pass--resolve-env. (#7553)- HTTPS on the local API with
stack start— set[api.tls]to serve https on the API port, using the built-in cert or your owncert_pathandkey_path. Plain http still works for loopback. Tls on or off applies on the nextstack start. macOS (Docker Desktop, Colima, Podman machine) is supported; Linux Docker and Podman fail the start check. (#7539) supabase stack prune— finds and destroys local stacks whose project directory no longer exists, such as deleted worktrees. Use--dry-runto list them first, and--yesin CI or agent runs. (#7624)
New features
supabase config convert— rewritesconfig.tomlasconfig.jsoncand removes the TOML file. It only writes if the converted file parses back to the same values. Use--dry-runto preview. Note that the JSONC file needs a CLI version that reads it; the command prints the minimum version. (#7517)[local.services.<name>.container]limits — setmemory(e.g.2GiB) andcpus(e.g.1.5) for local stack containers. Swap is disabled. Edits show as drift instack statusuntil you stop and start the stack. Ignored by the native runtime. (#7604)[api] db_pool— sets PostgREST's local connection pool size, which is useful when tests fire many Data API calls at once. Unset keeps the current pool. It's local only and never touches a linked project. (#7584)
Improvements
- Removed config keys now say what to use instead — for example,
inbucketpoints tolocal_smtp. The error stays a hard error with exit 1. (#7593) gen types --schemawarns on stderr when a named schema is missing from the output, which catches typos and schemas the role can't see. Stdout and exit codes are unchanged. (#7627)- Plan-gate denials show the upgrade hint consistently across commands, and the telemetry event fires the same way everywhere. (#7441)
bootstrapprefills the directory prompt with the current directory, so a quick Enter no longer silently overwrites an existing project. Scripts and--workdirbehave as before. (#7613)- Stack opt-in hint — when a stack-only flag like
--runtimeis rejected by the legacy backend, the error now tells you to setSUPABASE_EXPERIMENTAL_STACK=1orstack = trueunder[experimental]. (#7592)
Bug fixes
- Fewer macOS Keychain password prompts —
bootstrapand severalprojects/orgs/secretscommands read the access token once per run instead of up to seven times. (#7610) gen typeson Postgres 14 now marks view andRETURNS TABLEcolumns non-null where it can infer them, matching Postgres 15+. Postgres 15+ output is unchanged. (#7599)gen typesreturn types forRETURNS TABLEfunctions are more accurate because the typegen dependency was bumped. (#7585)supabase startno longer fails on restart whensupabase/functions/.envhas a multiline value such as a PEM key on Docker Desktop. (#7607)supabase startis less flaky for Logflare and Vector, which now get a 60s health budget instead of 30s. (#7551)supabase start,stopand rollback no longer fail with "a prune operation is already running" when several stacks share a Docker daemon. (#7550)db dumpanddb pushnow pin the Supabase CA like the otherdbcommands. (#7616)- Default region is no longer the private
ap-east-1. (#7609) - Stack
roles.sqlruns once, aspostgres— it no longer re-runs on later starts (which failed with "role already exists") or fails migrations with "permission denied for schema". (#7595) - Stack functions connect as
postgres, notsupabase_admin, so local function SQL matches deployed functions. A stack created earlier picks this up on its nextstack start. (#7571) stack startaccepts storage analytics and vector buckets instead of refusing to start./storage/v1/icebergstill returns 404 locally. (#7545)api.tlsprobe reports a closed connection correctly instead of "can't reach" when the listener resets early. (#7590)
Gotchas
- Projects with
db.major_version = 13must change it before upgrading, or they will fail validation. - Postgres 14 still works, but
supabase startandsupabase db startprint a warning on every start. Postgres 14 reached end of life on November 12, 2026, and support will be removed in a later release.
Plus 2 internal improvements and dependency updates.
Full changelog: v3.1.0...v3.2.0