22 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.
Check updates for each service to learn more.
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 latest images and recreate containers - use docker compose pull && docker compose down && docker compose up -d.
Unreleased
[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
supabase/studio:2026.03.16-sha-5528817 - ⚠️ Added the link to 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 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 update) - 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 "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- Releases
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 configurations 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