|
|
|
|
@ -18,19 +18,179 @@ that your email address is probably `user@example.com` rather than
|
|
|
|
|
|
|
|
|
|
## Installing Synapse
|
|
|
|
|
|
|
|
|
|
### Installing from source
|
|
|
|
|
### Prebuilt packages
|
|
|
|
|
|
|
|
|
|
(Prebuilt packages are available for some platforms - see [Prebuilt packages](#prebuilt-packages).)
|
|
|
|
|
Prebuilt packages are available for a number of platforms. These are recommended
|
|
|
|
|
for most users.
|
|
|
|
|
|
|
|
|
|
When installing from source please make sure that the [Platform-specific prerequisites](#platform-specific-prerequisites) are already installed.
|
|
|
|
|
#### Docker images and Ansible playbooks
|
|
|
|
|
|
|
|
|
|
There is an official synapse image available at
|
|
|
|
|
<https://hub.docker.com/r/matrixdotorg/synapse> which can be used with
|
|
|
|
|
the docker-compose file available at
|
|
|
|
|
[contrib/docker](https://github.com/matrix-org/synapse/tree/develop/contrib/docker).
|
|
|
|
|
Further information on this including configuration options is available in the README
|
|
|
|
|
on hub.docker.com.
|
|
|
|
|
|
|
|
|
|
Alternatively, Andreas Peters (previously Silvio Fricke) has contributed a
|
|
|
|
|
Dockerfile to automate a synapse server in a single Docker image, at
|
|
|
|
|
<https://hub.docker.com/r/avhost/docker-matrix/tags/>
|
|
|
|
|
|
|
|
|
|
Slavi Pantaleev has created an Ansible playbook,
|
|
|
|
|
which installs the offical Docker image of Matrix Synapse
|
|
|
|
|
along with many other Matrix-related services (Postgres database, Element, coturn,
|
|
|
|
|
ma1sd, SSL support, etc.).
|
|
|
|
|
For more details, see
|
|
|
|
|
<https://github.com/spantaleev/matrix-docker-ansible-deploy>
|
|
|
|
|
|
|
|
|
|
#### Debian/Ubuntu
|
|
|
|
|
|
|
|
|
|
##### Matrix.org packages
|
|
|
|
|
|
|
|
|
|
Matrix.org provides Debian/Ubuntu packages of Synapse, for the amd64
|
|
|
|
|
architecture via <https://packages.matrix.org/debian/>.
|
|
|
|
|
|
|
|
|
|
To install the latest release:
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
sudo apt install -y lsb-release wget apt-transport-https
|
|
|
|
|
sudo wget -O /usr/share/keyrings/matrix-org-archive-keyring.gpg https://packages.matrix.org/debian/matrix-org-archive-keyring.gpg
|
|
|
|
|
echo "deb [signed-by=/usr/share/keyrings/matrix-org-archive-keyring.gpg] https://packages.matrix.org/debian/ $(lsb_release -cs) main" |
|
|
|
|
|
sudo tee /etc/apt/sources.list.d/matrix-org.list
|
|
|
|
|
sudo apt update
|
|
|
|
|
sudo apt install matrix-synapse-py3
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Packages are also published for release candidates. To enable the prerelease
|
|
|
|
|
channel, add `prerelease` to the `sources.list` line. For example:
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
sudo wget -O /usr/share/keyrings/matrix-org-archive-keyring.gpg https://packages.matrix.org/debian/matrix-org-archive-keyring.gpg
|
|
|
|
|
echo "deb [signed-by=/usr/share/keyrings/matrix-org-archive-keyring.gpg] https://packages.matrix.org/debian/ $(lsb_release -cs) main prerelease" |
|
|
|
|
|
sudo tee /etc/apt/sources.list.d/matrix-org.list
|
|
|
|
|
sudo apt update
|
|
|
|
|
sudo apt install matrix-synapse-py3
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
The fingerprint of the repository signing key (as shown by `gpg
|
|
|
|
|
/usr/share/keyrings/matrix-org-archive-keyring.gpg`) is
|
|
|
|
|
`AAF9AE843A7584B5A3E4CD2BCF45A512DE2DA058`.
|
|
|
|
|
|
|
|
|
|
##### Downstream Debian packages
|
|
|
|
|
|
|
|
|
|
We do not recommend using the packages from the default Debian `buster`
|
|
|
|
|
repository at this time, as they are old and suffer from known security
|
|
|
|
|
vulnerabilities. You can install the latest version of Synapse from
|
|
|
|
|
[our repository](#matrixorg-packages) or from `buster-backports`. Please
|
|
|
|
|
see the [Debian documentation](https://backports.debian.org/Instructions/)
|
|
|
|
|
for information on how to use backports.
|
|
|
|
|
|
|
|
|
|
If you are using Debian `sid` or testing, Synapse is available in the default
|
|
|
|
|
repositories and it should be possible to install it simply with:
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
sudo apt install matrix-synapse
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
##### Downstream Ubuntu packages
|
|
|
|
|
|
|
|
|
|
We do not recommend using the packages in the default Ubuntu repository
|
|
|
|
|
at this time, as they are old and suffer from known security vulnerabilities.
|
|
|
|
|
The latest version of Synapse can be installed from [our repository](#matrixorg-packages).
|
|
|
|
|
|
|
|
|
|
#### Fedora
|
|
|
|
|
|
|
|
|
|
Synapse is in the Fedora repositories as `matrix-synapse`:
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
sudo dnf install matrix-synapse
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Oleg Girko provides Fedora RPMs at
|
|
|
|
|
<https://obs.infoserver.lv/project/monitor/matrix-synapse>
|
|
|
|
|
|
|
|
|
|
#### OpenSUSE
|
|
|
|
|
|
|
|
|
|
Synapse is in the OpenSUSE repositories as `matrix-synapse`:
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
sudo zypper install matrix-synapse
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
#### SUSE Linux Enterprise Server
|
|
|
|
|
|
|
|
|
|
Unofficial package are built for SLES 15 in the openSUSE:Backports:SLE-15 repository at
|
|
|
|
|
<https://download.opensuse.org/repositories/openSUSE:/Backports:/SLE-15/standard/>
|
|
|
|
|
|
|
|
|
|
#### ArchLinux
|
|
|
|
|
|
|
|
|
|
The quickest way to get up and running with ArchLinux is probably with the community package
|
|
|
|
|
<https://www.archlinux.org/packages/community/any/matrix-synapse/>, which should pull in most of
|
|
|
|
|
the necessary dependencies.
|
|
|
|
|
|
|
|
|
|
pip may be outdated (6.0.7-1 and needs to be upgraded to 6.0.8-1 ):
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
sudo pip install --upgrade pip
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
If you encounter an error with lib bcrypt causing an Wrong ELF Class:
|
|
|
|
|
ELFCLASS32 (x64 Systems), you may need to reinstall py-bcrypt to correctly
|
|
|
|
|
compile it under the right architecture. (This should not be needed if
|
|
|
|
|
installing under virtualenv):
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
sudo pip uninstall py-bcrypt
|
|
|
|
|
sudo pip install py-bcrypt
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
#### Void Linux
|
|
|
|
|
|
|
|
|
|
Synapse can be found in the void repositories as 'synapse':
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
xbps-install -Su
|
|
|
|
|
xbps-install -S synapse
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
#### FreeBSD
|
|
|
|
|
|
|
|
|
|
Synapse can be installed via FreeBSD Ports or Packages contributed by Brendan Molloy from:
|
|
|
|
|
|
|
|
|
|
- Ports: `cd /usr/ports/net-im/py-matrix-synapse && make install clean`
|
|
|
|
|
- Packages: `pkg install py37-matrix-synapse`
|
|
|
|
|
|
|
|
|
|
#### OpenBSD
|
|
|
|
|
|
|
|
|
|
As of OpenBSD 6.7 Synapse is available as a pre-compiled binary. The filesystem
|
|
|
|
|
underlying the homeserver directory (defaults to `/var/synapse`) has to be
|
|
|
|
|
mounted with `wxallowed` (cf. `mount(8)`), so creating a separate filesystem
|
|
|
|
|
and mounting it to `/var/synapse` should be taken into consideration.
|
|
|
|
|
|
|
|
|
|
Installing Synapse:
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
doas pkg_add synapse
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
#### NixOS
|
|
|
|
|
|
|
|
|
|
Robin Lambertz has packaged Synapse for NixOS at:
|
|
|
|
|
<https://github.com/NixOS/nixpkgs/blob/master/nixos/modules/services/misc/matrix-synapse.nix>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
### Installing as a Python module from PyPI
|
|
|
|
|
|
|
|
|
|
It's also possible to install Synapse as a Python module from PyPI.
|
|
|
|
|
|
|
|
|
|
When following this route please make sure that the [Platform-specific prerequisites](#platform-specific-prerequisites) are already installed.
|
|
|
|
|
|
|
|
|
|
System requirements:
|
|
|
|
|
|
|
|
|
|
- POSIX-compliant system (tested on Linux & OS X)
|
|
|
|
|
- Python 3.5.2 or later, up to Python 3.9.
|
|
|
|
|
- Python 3.6 or later, up to Python 3.9.
|
|
|
|
|
- At least 1GB of free RAM if you want to join large public rooms like #matrix:matrix.org
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
To install the Synapse homeserver run:
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
@ -203,164 +363,6 @@ be found at <https://docs.microsoft.com/en-us/windows/wsl/install-win10> for
|
|
|
|
|
Windows 10 and <https://docs.microsoft.com/en-us/windows/wsl/install-on-server>
|
|
|
|
|
for Windows Server.
|
|
|
|
|
|
|
|
|
|
### Prebuilt packages
|
|
|
|
|
|
|
|
|
|
As an alternative to installing from source, prebuilt packages are available
|
|
|
|
|
for a number of platforms.
|
|
|
|
|
|
|
|
|
|
#### Docker images and Ansible playbooks
|
|
|
|
|
|
|
|
|
|
There is an official synapse image available at
|
|
|
|
|
<https://hub.docker.com/r/matrixdotorg/synapse> which can be used with
|
|
|
|
|
the docker-compose file available at
|
|
|
|
|
[contrib/docker](https://github.com/matrix-org/synapse/tree/develop/contrib/docker).
|
|
|
|
|
Further information on this including configuration options is available in the README
|
|
|
|
|
on hub.docker.com.
|
|
|
|
|
|
|
|
|
|
Alternatively, Andreas Peters (previously Silvio Fricke) has contributed a
|
|
|
|
|
Dockerfile to automate a synapse server in a single Docker image, at
|
|
|
|
|
<https://hub.docker.com/r/avhost/docker-matrix/tags/>
|
|
|
|
|
|
|
|
|
|
Slavi Pantaleev has created an Ansible playbook,
|
|
|
|
|
which installs the offical Docker image of Matrix Synapse
|
|
|
|
|
along with many other Matrix-related services (Postgres database, Element, coturn,
|
|
|
|
|
ma1sd, SSL support, etc.).
|
|
|
|
|
For more details, see
|
|
|
|
|
<https://github.com/spantaleev/matrix-docker-ansible-deploy>
|
|
|
|
|
|
|
|
|
|
#### Debian/Ubuntu
|
|
|
|
|
|
|
|
|
|
##### Matrix.org packages
|
|
|
|
|
|
|
|
|
|
Matrix.org provides Debian/Ubuntu packages of Synapse via
|
|
|
|
|
<https://packages.matrix.org/debian/>. To install the latest release:
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
sudo apt install -y lsb-release wget apt-transport-https
|
|
|
|
|
sudo wget -O /usr/share/keyrings/matrix-org-archive-keyring.gpg https://packages.matrix.org/debian/matrix-org-archive-keyring.gpg
|
|
|
|
|
echo "deb [signed-by=/usr/share/keyrings/matrix-org-archive-keyring.gpg] https://packages.matrix.org/debian/ $(lsb_release -cs) main" |
|
|
|
|
|
sudo tee /etc/apt/sources.list.d/matrix-org.list
|
|
|
|
|
sudo apt update
|
|
|
|
|
sudo apt install matrix-synapse-py3
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Packages are also published for release candidates. To enable the prerelease
|
|
|
|
|
channel, add `prerelease` to the `sources.list` line. For example:
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
sudo wget -O /usr/share/keyrings/matrix-org-archive-keyring.gpg https://packages.matrix.org/debian/matrix-org-archive-keyring.gpg
|
|
|
|
|
echo "deb [signed-by=/usr/share/keyrings/matrix-org-archive-keyring.gpg] https://packages.matrix.org/debian/ $(lsb_release -cs) main prerelease" |
|
|
|
|
|
sudo tee /etc/apt/sources.list.d/matrix-org.list
|
|
|
|
|
sudo apt update
|
|
|
|
|
sudo apt install matrix-synapse-py3
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
The fingerprint of the repository signing key (as shown by `gpg
|
|
|
|
|
/usr/share/keyrings/matrix-org-archive-keyring.gpg`) is
|
|
|
|
|
`AAF9AE843A7584B5A3E4CD2BCF45A512DE2DA058`.
|
|
|
|
|
|
|
|
|
|
##### Downstream Debian packages
|
|
|
|
|
|
|
|
|
|
We do not recommend using the packages from the default Debian `buster`
|
|
|
|
|
repository at this time, as they are old and suffer from known security
|
|
|
|
|
vulnerabilities. You can install the latest version of Synapse from
|
|
|
|
|
[our repository](#matrixorg-packages) or from `buster-backports`. Please
|
|
|
|
|
see the [Debian documentation](https://backports.debian.org/Instructions/)
|
|
|
|
|
for information on how to use backports.
|
|
|
|
|
|
|
|
|
|
If you are using Debian `sid` or testing, Synapse is available in the default
|
|
|
|
|
repositories and it should be possible to install it simply with:
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
sudo apt install matrix-synapse
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
##### Downstream Ubuntu packages
|
|
|
|
|
|
|
|
|
|
We do not recommend using the packages in the default Ubuntu repository
|
|
|
|
|
at this time, as they are old and suffer from known security vulnerabilities.
|
|
|
|
|
The latest version of Synapse can be installed from [our repository](#matrixorg-packages).
|
|
|
|
|
|
|
|
|
|
#### Fedora
|
|
|
|
|
|
|
|
|
|
Synapse is in the Fedora repositories as `matrix-synapse`:
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
sudo dnf install matrix-synapse
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Oleg Girko provides Fedora RPMs at
|
|
|
|
|
<https://obs.infoserver.lv/project/monitor/matrix-synapse>
|
|
|
|
|
|
|
|
|
|
#### OpenSUSE
|
|
|
|
|
|
|
|
|
|
Synapse is in the OpenSUSE repositories as `matrix-synapse`:
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
sudo zypper install matrix-synapse
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
#### SUSE Linux Enterprise Server
|
|
|
|
|
|
|
|
|
|
Unofficial package are built for SLES 15 in the openSUSE:Backports:SLE-15 repository at
|
|
|
|
|
<https://download.opensuse.org/repositories/openSUSE:/Backports:/SLE-15/standard/>
|
|
|
|
|
|
|
|
|
|
#### ArchLinux
|
|
|
|
|
|
|
|
|
|
The quickest way to get up and running with ArchLinux is probably with the community package
|
|
|
|
|
<https://www.archlinux.org/packages/community/any/matrix-synapse/>, which should pull in most of
|
|
|
|
|
the necessary dependencies.
|
|
|
|
|
|
|
|
|
|
pip may be outdated (6.0.7-1 and needs to be upgraded to 6.0.8-1 ):
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
sudo pip install --upgrade pip
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
If you encounter an error with lib bcrypt causing an Wrong ELF Class:
|
|
|
|
|
ELFCLASS32 (x64 Systems), you may need to reinstall py-bcrypt to correctly
|
|
|
|
|
compile it under the right architecture. (This should not be needed if
|
|
|
|
|
installing under virtualenv):
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
sudo pip uninstall py-bcrypt
|
|
|
|
|
sudo pip install py-bcrypt
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
#### Void Linux
|
|
|
|
|
|
|
|
|
|
Synapse can be found in the void repositories as 'synapse':
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
xbps-install -Su
|
|
|
|
|
xbps-install -S synapse
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
#### FreeBSD
|
|
|
|
|
|
|
|
|
|
Synapse can be installed via FreeBSD Ports or Packages contributed by Brendan Molloy from:
|
|
|
|
|
|
|
|
|
|
- Ports: `cd /usr/ports/net-im/py-matrix-synapse && make install clean`
|
|
|
|
|
- Packages: `pkg install py37-matrix-synapse`
|
|
|
|
|
|
|
|
|
|
#### OpenBSD
|
|
|
|
|
|
|
|
|
|
As of OpenBSD 6.7 Synapse is available as a pre-compiled binary. The filesystem
|
|
|
|
|
underlying the homeserver directory (defaults to `/var/synapse`) has to be
|
|
|
|
|
mounted with `wxallowed` (cf. `mount(8)`), so creating a separate filesystem
|
|
|
|
|
and mounting it to `/var/synapse` should be taken into consideration.
|
|
|
|
|
|
|
|
|
|
Installing Synapse:
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
doas pkg_add synapse
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
#### NixOS
|
|
|
|
|
|
|
|
|
|
Robin Lambertz has packaged Synapse for NixOS at:
|
|
|
|
|
<https://github.com/NixOS/nixpkgs/blob/master/nixos/modules/services/misc/matrix-synapse.nix>
|
|
|
|
|
|
|
|
|
|
## Setting up Synapse
|
|
|
|
|
|
|
|
|
|
Once you have installed synapse as above, you will need to configure it.
|
|
|
|
|
|
Olivier Wilkinson (reivilibre)