Skip to content
Snippets Groups Projects
INSTALL.md 16.49 KiB

Choosing your server name

It is important to choose the name for your server before you install Synapse, because it cannot be changed later.

The server name determines the "domain" part of user-ids for users on your server: these will all be of the format @user:my.domain.name. It also determines how other matrix servers will reach yours for federation.

For a test configuration, set this to the hostname of your server. For a more production-ready setup, you will probably want to specify your domain (example.com) rather than a matrix-specific hostname here (in the same way that your email address is probably user@example.com rather than user@email.example.com) - but doing so may require more advanced setup: see Setting up Federation.

Installing Synapse

Installing from source

(Prebuilt packages are available for some platforms - see Prebuilt packages.)

System requirements:

  • POSIX-compliant system (tested on Linux & OS X)
  • Python 3.5, 3.6, or 3.7
  • At least 1GB of free RAM if you want to join large public rooms like #matrix:matrix.org