Levelrail
Skip to content

Self-host Matrix Synapse with Docker ​

A federated, end-to-end encrypted chat server implementing the Matrix protocol.

This page describes the Levelrail template for Matrix Synapse (Communication). It deploys the services below as one Docker Compose app on your own server.

Project site: https://element-hq.github.io/synapse/latest/setup/installation.html.

Recommended memory: about 1024 MiB.

Services, ports and volumes ​

ServiceImageContainer portsVolumes
synapsematrixdotorg/synapse:v1.145.08008
synapse_data -> /data

Environment variables ​

ServiceVariableValue
synapseSYNAPSE_REPORT_STATSPreset in the template
synapseSYNAPSE_SERVER_NAMEPreset in the template

Passwords and keys marked as generated are created for you when the app is deployed and stored as secrets. Values are not shown here.

Deploy Matrix Synapse with Levelrail ​

In the dashboard, open Apps, choose New app, then Browse templates, and select Matrix Synapse. Review the Compose body and deploy.

With the CLI:

levelrail-cli templates deploy matrix-synapse --name my-matrix-synapse

See Service template catalog for how templates work, and Getting started if you have not installed Levelrail yet.

More Communication templates ​

All templates are listed in the self-host gallery.

Released under the Apache 2.0 License.