Native Federation is currently in its final stability and performance tuning phase. While the feature is already suitable for evaluation and non-critical use cases, you may occasionally encounter intermittent behavior as we complete ongoing audits and optimizations. For this reason, we currently recommend avoiding Native Federation for mission-critical workloads until the final stabilization phase is complete.
Overview
Native Federation in Rocket.Chat enables organizations to securely collaborate across independent workspaces while maintaining full control over their data and infrastructure.
Introduced in version 7.11, Native Federation is Rocket.Chat’s built-in implementation of the Matrix protocol. Unlike earlier versions that depended on an external Synapse homeserver, Native Federation:
Runs natively inside Rocket.Chat
Requires no external services or additional databases
Provides improved performance, governance, and integration
Built on the Matrix protocol, Rocket.Chat enables secure and interoperable collaboration across federated networks for teams, partners, and external organizations.
Benefits of Native Federation
Native Federation uses the Matrix protocol to enable secure, decentralized, and interoperable communication between independent workspaces.
Native Federation is ideal for organizations that need:
Business need | How Native Federation helps |
|---|---|
Data sovereignty & security | Each workspace maintains full ownership of its data. Messages, files, and room state are stored locally and shared only when necessary, enabling secure cross-organization communication without giving up control to third-party servers. |
Access control | Access to federated communication in Rocket.Chat is currently controlled through workspace permissions. Users must be explicitly granted the |
Built-in homeserver, no external components | Native Federation runs directly inside Rocket.Chat, simplifying deployment and removing the need for external Synapse servers, extra databases, or standalone components. |
Lower total cost of ownership (TCO) & reduced complexity | Organizations using traditional federation stacks often manage multiple external components, such as a Synapse Python server paired with a dedicated PostgreSQL database. Native Federation eliminates this multi-component architecture, reducing maintenance overhead, operational complexity, and long-term infrastructure costs. |
Guaranteed performance baseline | Because the homeserver is built directly into Rocket.Chat, the platform can optimize performance holistically. Native Federation is designed to achieve high SLA targets with minimal resource consumption, providing predictable performance without the heavy footprint of external homeserver deployments. |
Cross-organization collaboration | Teams can communicate with external partners, vendors, agencies, or customers while keeping their internal workspace separate and secure. Federated rooms allow distributed groups to collaborate seamlessly. |
Interoperability through open standards | Built on the Matrix protocol, Native Federation supports communication between Rocket.Chat and other Matrix-based platforms, ensuring long-term compatibility and flexibility. |
Independent infrastructure | Each server operates as its own autonomous system. If one workspace goes offline or loses connectivity, other servers continue operating without disruption. |
Future-proof collaboration | As Matrix evolves, federation capabilities will continue expanding, bringing more secure and interoperable features to Rocket.Chat. |
Architecture preview
Native Federation in Rocket.Chat is powered by an embedded Matrix homeserver that runs directly inside the Rocket.Chat application. Instead of relying on an external Synapse server, Rocket.Chat now acts as its own federation engine, allowing workspaces to communicate securely and independently. At a high level, the architecture works as follows:

Key capabilities
Rocket.Chat Native Federation enables cross-server communication using the Matrix protocol. The following capabilities are supported in the current Beta implementation:
Federated features | Supported capabilities |
|---|---|
Messaging | Send, receive, edit, and delete messages across federated servers, with consistent delivery and synchronization. |
Message interactions | Native Federation aims to support a wide range of message interaction features to keep conversations consistent across homeservers.
|
Direct messaging across servers | Start one-to-one conversations with users on external domains with full invitation handling and membership lifecycle support. |
Typing indicators | Federated rooms may display typing indicators when remote users are composing a message. |
Federated group rooms | Create rooms containing both local and remote users, with synchronized membership events. |
Federated invitations | Invite remote users to direct messages and group rooms. Invitation acceptance, decline, and membership updates are synchronized across all participating servers. |
Room management | Update room details such as name and topic and synchronize changes across federated servers. |
Room role & membership synchronization | Maintain consistent roles and membership across homeservers, including owners, moderators, and members. |
File sharing | Share files between federated users within supported size limits (50 MB). |
Current limitations
Native Federation is currently in Beta, and several capabilities are still in progress or not yet fully supported. The table below summarizes the key limitations users and administrators should be aware of.
Area | Limitation | Details |
|---|---|---|
End-to-End Encryption | Not supported | Encrypted rooms and messages cannot be exchanged between federated servers. |
Public room discovery | Not supported | Searching or browsing public rooms hosted on other homeservers is unavailable. |
Message history backfill | Partial / configurable support not available | Remote users can access existing room history after joining, but administrators cannot yet control or restrict whether history is visible to newly joined users. History access is always enabled until configuration options are introduced. |
Read receipts | Not supported | Read receipts are intentionally suppressed in federated rooms to prevent inconsistent or misleading indicators. |
Voice / video calls | Not supported | Audio and video calling are disabled in federated rooms. |
Auto-translation | Local only | Translated messages do not propagate to remote servers. |
Discussions | Not supported (will be restricted) | While Discussions may currently appear to work in federated rooms, they are not supported by the Matrix protocol and will be disabled in future releases to prevent inconsistent or unreliable behavior. |
File upload size limits | Limited | Files above 50 MB may not propagate to remote servers; large files remain local. |
Room & user deletion | Not synchronized | Deleting rooms or users locally does not remove them on remote servers. Full federation of deletion events is planned after Beta. |
Slash commands | Partially supported |
|
Legacy federation (synapse-based) | Not supported | Rooms created under the old external-homeserver approach will not function with Native Federation. |
Matrix protocol version | Limited | Rocket.Chat currently supports Matrix v.11, not newer versions. |
Performance considerations
Native Federation is still undergoing performance tuning. While core features are functional, certain scenarios may exhibit reduced performance under high load or unstable network conditions.
Large rooms: Very large federated rooms may experience slower message history loading or temporary gaps in the timeline. Performance continues to improve as the system is optimized during the Beta cycle.
Unstable or intermittent connectivity: During periods of network instability, users may notice brief synchronization delays or minor inconsistencies in message delivery. Enhanced resilience for intermittent connectivity is planned for post-Beta releases.
Learn more
Explore the full set of Native Federation guides to configure, manage, and troubleshoot federated communication in Rocket.Chat:
Additional Native Federation documentation links will be added here after all related pages are completed.