Installing Synapse

Synapse is the most widely installed Matrix homeserver implementation. It is written in Python 3.

Many guides have been written explaining how to install Synapse, but there is sometimes confusion about the exact steps. has recommended methods for installing Synapse:

Install from source in the Synapse repo itself has clear instructions on installation.


Slavi has created a very useful set of Ansible playbooks which install containerised instances of multiple Matrix-ecosystem packages, the Synapse container being the centerpiece of these.

You can find the playbooks at, and there are instructions included in the repo.

To talk about the playbooks or get installation support, talk in

It's also possible to use Docker containers without Ansible, just follow the intructions in the Synapse Docker README.

Further help

For further help join