Installing Synapse

Synapse is the most widely installed Matrix homeserver implementation. It is written in Python - originally Python 2, but a Python 3 implementation is available and is set to become the new standard.

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.


First, 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.

Installation guide for Ubuntu recommends this guide hosted by as a guide to installing Synapse manually. It is written specifically for Ubuntu 18.04 LTS, but many of the steps can be generalised to any Linux distro.

For further help join, or to give feedback about this guide visit