nixos.matrix-synapse: Clarify documentation of server_name.

Matrix homeservers have two important domains. The user-visible server_name and the homeserver domain which serves most of the traffic but is really seen by users. The docs around this variable said "This is used by remote servers to connect to this server" which is very confusing because most of the remote server traffic actually goes the server domain, not the server_name domain. (The server_name domain is only used to fetch the .well-known file that points at the server domain).

I largely copied the wording from https://matrix-org.github.io/synapse/latest/usage/configuration/homeserver_sample_config.html as I found it much more clear.
launchpad/nixpkgs/master
Kevin Cox 3 years ago
parent e37a0aa5d9
commit 6f7fc1c693
No known key found for this signature in database
GPG Key ID: 9BB92CC1552E99AA
  1. 5
      nixos/modules/services/misc/matrix-synapse.nix

@ -221,9 +221,10 @@ in {
default = config.networking.hostName;
description = ''
The domain name of the server, with optional explicit port.
This is used by remote servers to connect to this server,
e.g. matrix.org, localhost:8080, etc.
This is used by remote servers to look up the server address.
This is also the last part of your UserID.
The server_name cannot be changed later so it is important to configure this correctly before you start Synapse.
'';
};
public_baseurl = mkOption {

Loading…
Cancel
Save