27 KiB
Changelog
All notable changes to the Supabase self-hosted Docker configuration.
Changes are grouped by service rather than by change type. See versions.md for complete image version history and rollback information.
See per-service updates below for details.
Note: Configuration updates marked with "requires [...] update" are already included in the latest version of the repository. Pull the latest changes or refer to the linked PR for manual updates. After updating docker-compose.yml, pull the latest images and recreate containers - use docker compose pull && docker compose down && docker compose up -d.
Unreleased
⚠️ Upcoming default changes: In a future release, several defaults will change: Postgres 15 → 17, Kong → Envoy, MinIO → RustFS, Analytics/Vector removed from the default stack, and the new API keys and authentication replacing the "legacy" architecture. Most of these are already available as optional configurations.
[2026-04-27]
Configuration
- ⚠️ Added
docker-compose.envoy.ymlandvolumes/api/envoy- PR #43838. See also the API gateway updates below - ⚠️ Changed Studio healthcheck and some other configuration for better compatibility with Podman (requires
docker-compose.ymlupdate) - PR #44754 - ⚠️ Changed Studio configuration to bind to all IPv4 interfaces only (requires
docker-compose.ymlupdate) - PR #44772
Documentation
- Added a new how-to describing how to switch from
supabase_admintopostgresrole for Studio - PR #42975 (via @singh-inder) - Added a new how-to for configuring Envoy as the new API gateway - PR #45152
- Updated the main setup guide and the how-tos to reflect the state of the self-hosted Supabase configuration - PR #45011
Utils
- ⚠️ Added
reassign-owner.shto update database objects - PR #42975. Read more in the "Remove superuser access" how-to guide - ⚠️ Changed
add-new-auth-keys.shto also updatedocker-compose.yml- PR #45056
Studio
- Updated to
2026.04.27-sha-5f60601 - ⚠️ Added 4 new lints to the Security Advisor - PR #45253, PR #45260. Read more about lint rules 0026 - 0029 in the Performance and Security Advisors section of the Supabase documentation
API gateway
- ⚠️ Added Envoy as the new optional API gateway (requires
docker-compose.envoy.yml,volumes/api/envoy, andvolumes/logs/vector.ymlupdate) - PR #43838 (via @luizfelmach)
[2026-04-08]
Documentation
- Added new how-to guides for configuring custom email templates, setting up SAML SSO, and using Postgres 17 - PR #42832, PR #43386, PR #44147
Utils
- ⚠️ Added
upgrade-pg17.sh- PR #44147. Read more in the "Upgrade to Postgres 17" how-to guide
Studio
- Updated to
2026.04.08-sha-205cbe7
API gateway
- ⚠️ Added configuration for SAML SSO (requires
.env,docker-compose.ymlandvolumes/api/kong.ymlupdate) - PR #43385 (via @luizfelmach)
PostgREST
Storage
- Updated to
v1.48.26- Release
imgproxy
- Changed
IMGPROXY_ENABLE_WEBP_DETECTIONenvironment variable toIMGPROXY_AUTO_WEBP(requires.envanddocker-compose.ymlupdate) - PR #43919
Postgres Meta
- Updated to
v0.96.3- Release
Analytics (Logflare)
- Updated to
v1.36.1- Release
Postgres
- ⚠️ Added
docker-compose.pg17.ymloverride - PR #44147 - ⚠️ Added
upgrade-pg17.sh- PR #44147 - ⚠️ Added documentation explaining the upgrade to Postgres 17
[2026-03-16]
⚠️ Note: This update includes important changes. Please check the details below. The following configuration files have been added/updated: utils/add-new-auth-keys.sh, utils/rotate-new-api-keys.sh, docker-compose.yml, .env.example, docker-compose.s3.yml, docker-compose.rustfs.yml, volumes/api/kong.yml, volumes/api/kong-entrypoint.sh, docker-compose.caddy.yml, docker-compose.nginx.yml, volumes/functions/main/index.ts, and volumes/proxy.
Configuration
- ⚠️ Added scripts and templates to support the new API key format (
sb_API keys) and the new asymmetric authentication - PR #43554; see the how-to guide for detailed instructions - Added optional proxy configuration for Caddy and nginx - PR #43291; read the how-to guide to learn more
Documentation
- Added several new how-to guides to the self-hosted Supabase documentation - PR #42745, PR #42953, PR #43177, PR #43286, PR #43293
Utils and tests
- Added
add-new-auth-keys.shandrotate-new-api-keys.sh- PR #43554 - Added
./testswith 100+ test cases - PR #43573
Studio
- Updated to
2026.03.16-sha-5528817 - ⚠️ Added the link to the Data API page in Integrations - PR #43268
- ⚠️ Added
PGRST_DB_SCHEMAS,PGRST_DB_EXTRA_SEARCH_PATH, andPGRST_DB_MAX_ROWSto Studio configuration (requiresdocker-compose.ymlupdate) - PR #43268
MCP Server
- Updated to
v0.7.0- Release
API gateway
- ⚠️ Updated Kong to
3.9.1- PR #43554
PostgREST
Realtime
- ⚠️ Added mandatory
METRICS_JWT_SECRETenvironment variable (requiresdocker-compose.s3.ymlupdate) - PR realtime#1729
Storage
- Updated to
v1.44.2- Release - ⚠️ Added
STORAGE_PUBLIC_URLenvironment variable to simplify proxy configuration (requiresdocker-compose.s3.ymlupdate) - PR storage#900 - ⚠️ Added RustFS as an optional S3 backend - PR #42935
- ⚠️ Changed Docker Compose configuration for S3 backends to use named volumes - PR #43815
Edge Runtime
- Updated to
v1.71.2- Release - ⚠️ Added
SUPABASE_PUBLISHABLE_KEYS,SUPABASE_SECRET_KEYS, andSUPABASE_PUBLIC_URLenvironment variables (requiresdocker-compose.ymlupdate) - ⚠️ Added an option for a "hybrid" JWT verification following the addition of the new API keys and the new asymmetric authentication (requires
volumes/functions/main/index.tsupdate) - PR #42130 - ⚠️ Added optional rate limiter - PR edge-runtime#670
[2026-02-18]
Storage
- Changed MinIO image to use Chainguard minio and minio-client (requires
docker-compose.s3.ymlupdate) - PR #42942 - Updated Storage image version to
v1.37.8indocker-compose.s3.yml - Removed
imgproxyservice fromdocker-compose.s3.ymlto minimize redundancy - PR #42942 - Fixed inconsistent
storageservice entry ordering indocker-compose.ymlanddocker-compose.s3.ymlto improve diff readability - PR #42942
Edge Runtime
- Added a
deno-cachenamed volume to avoid re-downloading dependencies (requiresdocker-compose.ymlandvolumes/functions/*update) - PR #40822
[2026-02-16]
⚠️ Note: This update includes several breaking changes, including a security fix for Analytics. Please check the details below. The following configuration files have been updated: docker-compose.yml, .env.example, docker-compose.s3.yml, volumes/api/kong.yml, and volumes/logs/vector.yml.
Studio
- Updated to
2026.02.16-sha-26c615c - Added Edge Functions management UI (requires
docker-compose.ymlupdate) - PR #40690, PR #42322, PR #42349, PR #42350
MCP Server
- Updated to
v0.6.3- Release
Auth
PostgREST
Realtime
- Updated to
v2.76.5- Release
Storage
- Updated to
v1.37.8- Release - ⚠️ Changed environment variable configuration for Storage (requires
docker-compose.yml,.env.exampleand.envupdate) - PR #37185, PR #42862 - ⚠️ Added default configuration to access buckets via
/storage/v1/s3endpoint (requiresdocker-compose.ymland.envupdate) - PR #37185 - ⚠️ Changed MinIO configuration for the S3 backend (requires
docker-compose.s3.ymland.envupdate) - PR #37185
Edge Runtime
- Updated to
v1.70.3- Release
Analytics (Logflare)
- Updated to
v1.31.2- Release - ⚠️ Changed default configuration to disable Logflare on
0.0.0.0:4000to prevent access to/dashboard(requiresdocker-compose.ymlupdate). Read more in the "Production Recommendations" section of Logflare documentation - PR #42857 - ⚠️ Changed Kong routes to not include
/analytics/v1by default (requires/volumes/api/kong.ymlupdate) - PR #42857
Vector
- Updated to
0.53.0-alpine- Changelog | Release - ⚠️ Major version jump from
0.28.1(requiresvolumes/logs/vector.ymlupdate) - PR #42525 - ⚠️ Changed Postgres sink configuration to bypass Kong (requires
volumes/logs/vector.ymlupdate) - PR #42857 - ⚠️ Changed retry settings for all sinks to increase timeouts (requires
volumes/logs/vector.ymlupdate) - PR #42857
[2026-02-05]
Storage
- Updated to
v1.37.1- Release - Fixed an issue with Storage not starting because of an issue with migrations - PR storage#845
[2026-01-27]
Studio
- Updated to
2026.01.27-sha-6aa59ff - Added SQL snippets (requires
docker-compose.ymlupdate) - PR #41112, PR #41557, discussion #42031 - Fixed type generator - PR #40481
- Fixed minor UI discrepancies - PR #40579, PR #41936, PR #41970, PR #41971, PR #41972, PR #42015
Auth
PostgREST
Realtime
- Updated to
v2.72.0- Release - Changed healthchecks logging to off by default (requires
docker-compose.ymlupdate) - PR realtime#1677, PR #42156 - Changed logging configuration and healthcheck frequency to reduce log volume (requires
docker-compose.ymlupdate) - PR #42112
Storage
- Updated to
v1.33.5- Release
imgproxy
Postgres Meta
- Updated to
v0.95.2- Release
Edge Runtime
- Updated to
v1.70.0- Release
Analytics (Logflare)
- Updated to
v1.30.3- Release
Postgres
- No image update
- Fixed Postgres logging configuration (requires
volumes/logs/vector.ymlupdate) - PR #41800
[2025-12-18]
Documentation
Utils
- Added
generate-keys.sh- PR #41363 - Added
db-passwd.sh- PR #41432 - Changed
reset.shto POSIX and added more checks - PR #41361
Studio
- Updated to
2025.12.17-sha-43f4f7f - ⚠️ Fixed additional issues related to React2Shell
- Fixed an issue with the Users page not being updated on changes - PR #41254
MCP Server
- Updated to
v0.5.10- Release
Auth
Postgres Meta
- Updated to
v0.95.1- Release
Analytics (Logflare)
- Updated to
v1.27.0- Release - Fixed multiple issues, including a race condition
[2025-12-10]
Studio
- Updated to
2025.12.09-sha-434634f - ⚠️ Fixed security issues related to React2Shell
MCP Server
- Updated to
v0.5.9- Release - ⚠️ Changed MCP tool
get_anon_keytoget_publishable_keys
PostgREST
- Updated to
v14.1- Changelog | Release - ⚠️ Major upgrade from v13.x to v14.x - please report any unexpected behavior
Realtime
- Updated to
v2.68.0- Release
Storage
- Updated to
v1.33.0- Release
Edge Runtime
- Updated to
v1.69.28- Release
Analytics (Logflare)
- Updated to
v1.26.25- Release
[2025-12-08]
Realtime
- No image update
- Changed boolean values to strings in Docker Compose for better compatibility with Podman - PR #40994, also PR realtime#1614
- Changed healthcheck in Docker Compose for better compatibility with Podman - PR #41159
[2025-11-26]
Studio
- Updated to
2025.11.26-sha-8f096b5 - Fixed MCP
get_advisorstool - PR #40783 - Fixed AI Assistant request schema - PR #40830
- Fixed log drains page - PR #40835
Realtime
- Updated to
v2.65.3- Release
Analytics (Logflare)
- Updated to
v1.26.13- Release - Fixed crashdump when
POSTGRES_BACKEND_URLis malformed - PR logflare#2954
[2025-11-25]
Studio
- Updated to
2025.11.24-sha-d990ae8- Dashboard updates - Fixed Queues configuration UI and added documentation for exposed queue schema - PR #40078
- Fixed parameterized SQL queries in MCP tools - PR #40499
- Fixed Studio showing paid options for log drains - PR #40510
- Fixed AI Assistant authentication - PR #40654
Auth
Realtime
- Updated to
v2.65.2- Release - Fixed handling of boolean configuration options - PR realtime#1614
Storage
- Updated to
v1.32.0- Release
Edge Runtime
- Updated to
v1.69.25- Release
Analytics (Logflare)
- Updated to
v1.26.12- Release - Fixed Auth logs query - PR logflare#2936
- Fixed build configuration to prevent crashes with "Illegal instruction (core dumped)" - PR logflare#2942
[2025-11-17]
Storage
- No image update
- Fixed resumable uploads for files larger than 6MB (requires
docker-compose.ymlupdate) - PR #40500
[2025-11-12]
Studio
- Updated to
2025.11.10-sha-5291fe3- Dashboard updates - Added log drains - PR #28297
- Fixed Studio using
postgresrole instead ofsupabase_admin- PR #39946
Auth
Realtime
- Updated to
v2.63.0- Release
Storage
- Updated to
v1.29.0- Release
Edge Runtime
- Updated to
v1.69.23- Release
Supavisor
- Updated to
v2.7.4- Release
[2025-11-05]
Studio
- No image update
- Fixed Studio failing to connect to Postgres with non-default settings (requires
docker-compose.ymlupdate) - PR #40169
Realtime
- No image update
- Fixed realtime logs not showing in Studio (requires
volumes/logs/vector.ymlupdate) - PR #39963
[2025-10-28]
Studio
- Updated to
2025.10.27-sha-85b84e0- Dashboard updates - Fixed broken authentication when uploading files to Storage - PR #39829
Realtime
- Updated to
v2.57.2- Release
Storage
- Updated to
v1.28.2- Release
Postgres Meta
- Updated to
v0.93.1- Release
Edge Runtime
- Updated to
v1.69.15- Release
[2025-10-27]
Studio
- No image update
- Added Kong configuration for MCP server routes (requires
volumes/api/kong.ymlupdate) - PR #39849 - Added documentation page for MCP server configuration - PR #39952
[2025-10-21]
Studio
- Updated to
2025.10.20-sha-5005fc6- Dashboard updates - Fixed issues with Edge Functions and cron logs not being visible in Studio - PR #39388, PR #39704, PR #39711
Realtime
- Updated to
v2.56.0- Release
Storage
- Updated to
v1.28.1- Release
Postgres Meta
- Updated to
v0.93.0- Release
Edge Runtime
- Updated to
v1.69.14- Release
Supavisor
- Updated to
v2.7.3- Release
[2025-10-13]
Analytics (Logflare)
- Updated to
v1.22.6- Release
[2025-10-08]
Studio
- Updated to
2025.10.01-sha-8460121- Dashboard updates - Added "local" remote MCP server - PR #38797, PR #39041
- ⚠️ Changed Studio connection method to
postgres-meta- affects non-standard database port configurations
Auth
- Updated to
v2.180.0- Release
PostgREST
Realtime
- Updated to
v2.51.11- Release
Storage
- Updated to
v1.28.0- Release
Postgres Meta
- Updated to
v0.91.6- Release
Analytics (Logflare)
- Updated to
v1.22.4- Release
Postgres
- Updated to
15.8.1.085- Release
Supavisor
- Updated to
2.7.0- Release