Synapse
Matrix homeserver
Element
Synapse is an open source Matrix homeserver implementation, written and maintained by Element. Matrix is the open standard for secure and interoperable real time communications.
💡 How It Works
To chat using Matrix, you'll need a client. You can find a list of popular clients here: https://matrix.org/ecosystem/clients/
In Matrix, each user operates one or more Matrix clients, which connect to a Matrix homeserver. The homeserver stores all personal chat history and user account information, similar to how a mail client connects to an IMAP/SMTP server. Like email, you can either run your own Matrix homeserver to control and own your communications and history, or use a hosted server (e.g., matrix.org). Matrix has no single point of control or mandatory service provider, unlike WhatsApp, Facebook, Hangouts, etc.
🛠️ Connecting a Client
To get started, install the "Element" app on your Umbrel, or install any other Matrix client on a device of your choice. When you register or login through the client, you will need to change the address of the homeserver you are logging into from the default matrix.org to http://umbrel.local:8008 for local access.
For seamless connection even when your client isn't connected to the same network as your Umbrel, simply install the "Tailscale" app on your Umbrel and your client device, and use http://umbrel:8008 as the address of your server.
This release fixes a bug that prevented certain authentication service endpoints from working correctly.
Full release notes are found at https://github.com/element-hq/synapse/releases
This release includes bug fixes and improvements, with support for Python 3.14 and a new Admin API for fetching space/room hierarchies.
Some of the key highlights include:
- Support for Python 3.14
- New Admin API to fetch space/room hierarchy for a given space
- Fixed handling of failed authenticated remote media downloads
- Fixed logcontext warnings in sync and internal requests
Full release notes are found at https://github.com/element-hq/synapse/releases
This release includes bug fixes and improvements, including a fix for users being unable to log in if their password was too long.
Some of the key highlights include:
- Stabilized support for device masquerading for appservices
- Docker images now based on Debian trixie with Python 3.13
Full release notes are found at https://github.com/element-hq/synapse/releases
⚠️ Deployments using the synapse-s3-storage-provider module must upgrade to v1.6.0 of that module.
Some of the key highlights in this release include:
- New Media Query by ID Admin API for investigating media metadata
- New Fetch Event Admin API to fetch an event by ID
- Support for signatures in Policy Servers implementation
- Experimental implementation of GET /_matrix/client/v1/rtc/transports endpoint for MatrixRTC
- New defer_to_threadpool function in Synapse Module API
Full release notes are found at https://github.com/element-hq/synapse/releases
This release contains bug fixes and performance improvements.
Full release notes are found at https://github.com/element-hq/synapse/releases
⚠️ If you are using Matrix Authentication Service (MAS), some older Application Services may experience issues when registering.
Some of the key highlights in this release include:
- Experimental support for Thread Subscriptions extension to Sliding Sync
- Updated push rules for Thread Subscriptions
- New module API callbacks for media repository
- Support for backwards-compatible redaction sending using the /send endpoint
- Performance improvements for cross-signing signatures and delayed events
- Various bugfixes and internal improvements
Full release notes are found at https://github.com/element-hq/synapse/releases
Some of the key highlights in this release include:
- Support for stable endpoint and scopes of MSC3861
- Improved database performance for MSC4293 (Redact on Kick/Ban)
- Fixed error when fetching rejected delayed state events on startup
- Updated worker documentation for room Admin API requests
- Improved tracing and instrumentation for performance monitoring
Full release notes are found at https://github.com/element-hq/synapse/releases
Some of the key highlights in this release include:
- Support for stable endpoint and scopes of MSC3861
- Improved database performance for MSC4293 (Redact on Kick/Ban)
- Fixed error when fetching rejected delayed state events on startup
- Updated worker documentation for room Admin API requests
- Improved tracing and instrumentation for performance monitoring
Full release notes are found at https://github.com/element-hq/synapse/releases
Some of the key highlights in this release include:
- Fixed issue that could corrupt auth chains and block state resolution
- Corrected error handling in user registration script
- Enabled MSC4108 support with the stable Matrix Authentication Service
- Improved coturn setup docs with IPv6 details
- Updated tests and tracing for more reliable performance
Full release notes are found at https://github.com/element-hq/synapse/releases
Some of the key highlights in this release include:
- Configurable rate limiting for room creation
- Support for MSC4293 (Redact on Kick/Ban)
- Admins can see spam policy flags on soft-failed events
- Configure outbound proxy in homeserver config
- Experimental MSC4306 (Thread Subscriptions) support and push rules
- Stable support for delegating auth to Matrix Authentication Service
- Bug fixes for federation profile fetching, suspended user notices, rate-limit logging, and storage cache invalidation
Full release notes are found at https://github.com/element-hq/synapse/releases
Some of the key highlights in this release include:
- Added support for reCAPTCHA integration
- Improved handling of plain text in rich-text topics
- Enhanced server admin visibility of certain events
- Introduced new reporting features
- Added ability to limit media uploads per user
- Improved device list handling for better performance
- Added support for custom profile fields
- Introduced experimental thread subscription feature
- Fixed issues with CPU and database usage during event retries and purging
- Improved tag creation limits for better compliance
- Fixed compatibility issues when migrating from SQLite to Postgres
- Resolved integration problems when running Synapse in daemon mode
Full release notes are found at https://github.com/element-hq/synapse/releases
Some of the key highlights in this release include:
- Added support for MSC4235 "via" query param for hierarchy endpoint
- Added "forget_forced_upon_leave" capability
- Improved performance of device deletion
- Fixed issues with profile queries over federation
- Enhanced handling of locked users during login attempts
- Improved handling of policy server events in rooms
Full release notes are found at https://github.com/element-hq/synapse/releases
Some of the key highlights in this release include:
- Added support for user report API
- Fixed issues with state resolution and power levels in v11 rooms
- Improved sliding sync to honor room inclusion config
- Enhanced performance for access token introspection with delegated auth
- Added logging for user deactivations
- Cleaned up old device federation inbox rows
Full release notes are found at https://github.com/element-hq/synapse/releases
Some of the key highlights in this release include:
- Added support for invite filtering to help manage unwanted invitations
- Introduced new module API callbacks for enhanced customization
- Added experimental support for configurable user types and rate limit overrides
- Improved application service transaction delivery with ping endpoint support
- Fixed room summary API incorrectly showing private rooms
- Prevented users from adding themselves to their own ignore list
Full release notes are found at https://github.com/element-hq/synapse/releases
Some of the key highlights in this release include:
- Added config option to limit key queries to users in shared rooms
- Allowed registrations starting with an underscore (_)
- Room deletion API now includes room ID in its response
- Added support for spam detection via Policy Servers
- Fixed a race condition during device resync
- Fixed a test timeout issue on RISC-V systems
- Fixed admin redaction not working on encrypted messages
Full release notes are found at https://github.com/element-hq/synapse/releases
Some of the key highlights in this release include:
- Added support for fetching scheduled tasks via a new Admin API endpoint
- Introduced a config option to exclude remote users from user directory search results
- Improved handling of push notifications and device management
- Fixed issues related to message ordering in certain rooms
⚠️ Room list publication remains disabled by default
Full release notes are found at https://github.com/element-hq/synapse/releases
Some of the key highlights in this release include:
- Added support for passing parameters to the authorization grant URL in OIDC configuration
- Improved efficiency with caching for token introspection and storage functions
- Fixed issues related to delegated authentication and MAS integration
- Optimized performance for room participation tracking
⚠️ Room list publication remains disabled by default
Full release notes are found at https://github.com/element-hq/synapse/releases
Some of the key highlights in this release include:
- Added an access token introspection cache for improved efficiency
- Added background job to clear unreferenced state groups
- Improved media file tracking and quarantine system
- Fixed a performance issue related to sliding sync membership snapshot table
⚠️ Room list publication is now disabled by default
Full release notes are found at https://github.com/element-hq/synapse/releases
🚨 This release includes a high severity security fix for a vulnerability affecting federation. The vulnerability has been exploited in the wild.
Some of the key highlights in this release include:
- Fixed a high severity security vulnerability (CVE-2025-30355)
- Updated implementation of delayed state events
- Added caching support to media endpoints
- Improved handling of user-sent state events
⚠️ Room list publication is now disabled by default
Full release notes are found at https://github.com/element-hq/synapse/releases
This release brings several enhancements and bug fixes to improve your Synapse experience.
Some of the key highlights in this release include:
- Updated implementation of delayed state events
- Added caching support to media endpoints
- Improved handling of user-sent state events
⚠️ Room list publication is now disabled by default
Full release notes are found at https://github.com/element-hq/synapse/releases
This release brings several enhancements and bug fixes to improve your Synapse experience.
Some of the key highlights in this release include:
- Added support for specifying OpenID identity provider settings
- Improved handling of suspended users and encrypted messages
- Enhanced configuration options for secrets and worker replication
- Added background job to clear unreferenced state groups
⚠️ Room list publication is now disabled by default
Full release notes are found at https://github.com/element-hq/synapse/releases
This release brings several enhancements and bug fixes to improve your Synapse experience. Some of the key highlights in this release include:
- Added functionality to use multiple values in SSO feature
attribute_requirements. - Improved handling of invalid email addresses when adding them to user accounts.
Full release notes are found at https://github.com/element-hq/synapse/releases
This release brings several important bug fixes to enhance the reliability of Synapse. Some of the key highlights in this release include:
- Fixed a regression in performance of sending events due to superfluous reads and locks.
- Addressed an issue where persisting events in some rooms could fail after a previous unclean shutdown.
- Deactivated users will no longer automatically accept an invite when
auto_accept_invitesis enabled. - Fixed a problem where joining was denied after being invited over federation.
- Resolved a rare edge case where state groups could be deleted while persisting new events.
Full release notes can be found at https://github.com/element-hq/synapse/releases
Between versions 1.55.0 and 1.123.0, several notable changes have been made to enhance the performance, security, and reliability of Synapse.
- Improved performance in event processing
- Enhanced rate limiting to prevent excessive presence updates
- Deactivated users no longer automatically accept invites
- Resolved issues with joining after being invited over federation
- Fixed rare cases where state groups could be deleted during event persistence
Full release notes can be found at https://github.com/element-hq/synapse/releases
