Matrix Synapse

Version: 1.61.0
Required minimum memory: 512MB
Last updated 14 Jun 2022

Recent Changes

  • Update Synapse to 1.61.0

  • Full changelog

  • Add new media_retention options to the homeserver config for routinely cleaning up non-recently accessed media. (#12732, #12972, #12977)

  • Experimental support for MSC3772: Push rule for mutually related events. (#12740, #12859)

  • Update to the check_event_for_spam module callback: Deprecate the current callback signature, replace it with a new signature that is both less ambiguous (replacing booleans with explicit allow/block) and more powerful (ability to return explicit error codes). (#12808)

  • Add storage and module API methods to get monthly active users (and their corresponding appservices) within an optionally specified time range. (#12838, #12917)

  • Support the new error code ORG.MATRIX.MSC3823.USER_ACCOUNT_SUSPENDED from MSC3823. (#12845, #12923)

  • Add a configurable background job to delete stale devices. (#12855)

  • Improve URL previews for pages with empty elements. (#12951)

  • Allow updating a user's password using the admin API without logging out their devices. Contributed by @jcgruenhage. (#12952)

This package only provides the Matrix backend. A variety of clients are available here. Riot is a popular web frontend for Matrix and is available as a separate app.


Matrix is an ambitious new ecosystem for open federated Instant Messaging and VoIP.

Matrix specifies a set of pragmatic RESTful HTTP JSON APIs as an open standard, which handle:

  • Creating and managing fully distributed chat rooms with no single points of control or failure
  • Eventually-consistent cryptographically secure synchronisation of room state across a global open network of federated servers and services
  • Sending and receiving extensible messages in a room with (optional) end-to-end encryption[1]
  • Inviting, joining, leaving, kicking, banning room members
  • Managing user accounts (registration, login, logout)
  • Using 3rd Party IDs (3PIDs) such as email addresses, phone numbers, Facebook accounts to authenticate, identify and discover users on Matrix.
  • Placing 1:1 VoIP and Video calls

What is Synapse?

Synapse is a reference "homeserver" implementation of Matrix from the core development team at, written in Python/Twisted.

Install Matrix Synapse in a few minutes on your server with Cloudron. To install Cloudron first, follow our setup steps.