- Elixir 91.2%
- PLpgSQL 3.5%
- TypeScript 3.3%
- HTML 0.9%
- JavaScript 0.4%
- Other 0.6%
| .github | ||
| assets | ||
| bench | ||
| config | ||
| deploy/fly | ||
| dev/postgres | ||
| forum | ||
| lib | ||
| priv | ||
| rel | ||
| test | ||
| .credo.exs | ||
| .dialyzer_ignore.exs | ||
| .dockerignore | ||
| .formatter.exs | ||
| .gitignore | ||
| .releaserc | ||
| .sobelow-conf | ||
| compose.dbs.yml | ||
| compose.tests.yml | ||
| compose.yml | ||
| CONTRIBUTING.md | ||
| coveralls.json | ||
| DEVELOPERS.md | ||
| Dockerfile | ||
| ENVS.md | ||
| ERROR_CODES.md | ||
| LICENSE | ||
| mise.lock | ||
| mise.toml | ||
| mix.exs | ||
| mix.lock | ||
| OBSERVABILITY_METRICS.md | ||
| phx_join.schema.json | ||
| README.md | ||
| run.sh | ||
Supabase Realtime
Send ephemeral messages, track and synchronize shared state, and listen to Postgres changes all over WebSockets.
Examples
·
Request Features
·
Report Bugs
Status
| Features | v1 | v2 | Status |
|---|---|---|---|
| Postgres Changes | ✔ | ✔ | GA |
| Broadcast | ✔ | GA | |
| Presence | ✔ | GA |
This repository focuses on version 2 but you can still access the previous version's code and Docker image. For the latest Docker images go to https://hub.docker.com/r/supabase/realtime.
The codebase is under heavy development and the documentation is constantly evolving. Give it a try and let us know what you think by creating an issue. Watch releases of this repo to get notified of updates. And give us a star if you like it!
Overview
What is this?
This is a server built with Elixir using the Phoenix Framework that enables the following functionality:
- Broadcast: Send ephemeral messages from client to clients with low latency.
- Presence: Track and synchronize shared state between clients.
- Postgres Changes: Listen to Postgres database changes and send them to authorized clients.
For a more detailed overview head over to Realtime guides.
Does this server guarantee message delivery?
The server does not guarantee that every message will be delivered to your clients so keep that in mind as you're using Realtime.
Quick start
You can check out the Supabase UI Library Realtime components and the repository of the multiplayer.dev demo app.
Developers
Start with DEVELOPERS.md for local setup, mise tasks, and example workflows.
Once your environment is up and running, check out the following docs to customize the server and troubleshooting:
- ENVS.md - detailed list of all environment variables
- ERROR_CODES.md - list of operational codes
- OBSERVABILITY_METRICS.md - monitoring information
Postgres compatibility
supabase/postgres version |
Role | Status |
|---|---|---|
| < 14 | - | Not officially supported. |
| 14.x | supabase_admin |
Requires superuser: log_min_messages can only be set by a superuser; supautils doesn't expose per-parameter delegation on this version. On <= 14.5, realtime.broadcast_changes(...) called from a trigger via PERFORM is unsupported. |
| 15.x < 15.14.1.018 | supabase_admin |
Requires superuser: supautils.policy_grants on realtime.subscription is missing until supabase/postgres@1b916920. |
| 15.x >= 15.14.1.018, 16.x, 17.x | supabase_admin |
Requires superuser to run migrations, no superuser needed for tenant grants. Policies are managed by supautils. |
Contributing
See CONTRIBUTING.md
Code of Conduct
See supabase/CODE_OF_CONDUCT.md
License
This repo is licensed under Apache 2.0.
Credits
- Phoenix -
Realtimeserver is built with the amazing Elixir framework. - Phoenix Channels JavaScript Client - @supabase/realtime-js client library heavily draws from the Phoenix Channels client library.