mirror of
https://github.com/supabase/supabase.git
synced 2026-10-05 09:25:06 +03:00
Matt Rossman
69333b9bb5
The Supabase MCP repo transferred from `supabase-community/supabase-mcp` -> `supabase/mcp`. This updates links on docs and www to point to the new location: https://github.com/supabase/mcp The main one needing this change is the MCP docs page at `mcp.mdx`: https://supabase.com/mcp I also updated links in the changelog / blog for good measure, though I can remove those changes if desired since the old URL redirects to the new location. Related: https://github.com/supabase/mcp/pull/295 Ref: AI-792 <!-- This is an auto-generated comment: release notes by coderabbit.ai --> ## Summary by CodeRabbit * **Documentation** * Updated Supabase MCP server repository references across all documentation guides, blog articles, changelog entries, and supporting materials to direct users to the current official location. * Refreshed documentation links including feature groups, setup instructions, abilities documentation, and GitHub issue tracking URLs for consistency. * Updated MCP server release links in changelog. <!-- end of auto-generated comment: release notes by coderabbit.ai -->
Self-Hosted Supabase with Docker
This is the official Docker Compose setup for self-hosted Supabase. It provides a complete stack with all Supabase services running locally or on your infrastructure.
Getting Started
Follow the detailed setup guide in our documentation: Self-Hosting with Docker
The guide covers:
- Prerequisites (Git and Docker)
- Initial setup and configuration
- Securing your installation
- Accessing services
- Updating your instance
What's Included
This Docker Compose configuration includes the following services:
- Studio - A dashboard for managing your self-hosted Supabase project
- Kong - Kong API gateway
- Auth - JWT-based authentication API for user sign-ups, logins, and session management
- PostgREST - Web server that turns your PostgreSQL database directly into a RESTful API
- Realtime - Elixir server that listens to PostgreSQL database changes and broadcasts them over websockets
- Storage - RESTful API for managing files in S3, with Postgres handling permissions
- imgproxy - Fast and secure image processing server
- postgres-meta - RESTful API for managing Postgres (fetch tables, add roles, run queries)
- PostgreSQL - Object-relational database with over 30 years of active development
- Edge Runtime - Web server based on Deno runtime for running JavaScript, TypeScript, and WASM services
- Logflare - Log management and event analytics platform
- Vector - High-performance observability data pipeline for logs
- Supavisor - Supabase's Postgres connection pooler
Documentation
- Self-Hosting with Docker - Setup and configuration guides
- CHANGELOG.md - Track recent updates and changes to services
- versions.md - Complete history of Docker image versions for rollback reference
- Ask DeepWiki / Supabase - DeepWiki-generated description of self-hosted configuration
- CONFIG.md - Configuration reference for all environment variables
Updates
To update your self-hosted Supabase instance:
- Review CHANGELOG.md for breaking changes
- Check versions.md for new image versions
- Update
docker-compose.ymlif there are configuration changes - Pull the latest images:
docker compose pull - Stop services:
docker compose down - Start services with new configuration:
docker compose up -d
Note: Consider to always backup your database before updating.
Community & Support
For troubleshooting common issues, see:
- GitHub Discussions - Questions, feature requests, and workarounds
- GitHub Issues - Known issues
- Documentation - Setup and configuration guides
Self-hosted Supabase is community-supported. Get help and connect with other users:
Share your self-hosting experience:
- GitHub Discussions - "Self-hosting: What's working (and what's not)?"
Important Notes
Security
⚠️ The default configuration is not secure for production use.
Before deploying to production, you must:
- Update all default passwords and secrets in the
.envfile - Review and update CORS settings
- Consider setting up a secure proxy in front of self-hosted Supabase
- Review and adjust network security configuration (ACLs, etc.)
- Set up proper backup procedures
See the main installation guide and the how-tos in the documentation.
License
This repository is licensed under the Apache 2.0 License. See the main Supabase repository for details.