diff options
author | piegames <git@piegames.de> | 2022-03-05 15:23:52 +0100 |
---|---|---|
committer | GitHub <noreply@github.com> | 2022-03-05 15:23:52 +0100 |
commit | be4a0e6e406a334b6dc50d343f7f81ff93f9e371 (patch) | |
tree | 185a975116f72866df6c2dc7f922b48682b94722 /nixos/doc/manual/from_md/release-notes | |
parent | e408a216837ff86aa2b0547f69f2e30d4f489ffe (diff) | |
parent | f799a02bca5ad00f8faa2737b7b37cf04289d59e (diff) | |
download | nixpkgs-be4a0e6e406a334b6dc50d343f7f81ff93f9e371.tar nixpkgs-be4a0e6e406a334b6dc50d343f7f81ff93f9e371.tar.gz nixpkgs-be4a0e6e406a334b6dc50d343f7f81ff93f9e371.tar.bz2 nixpkgs-be4a0e6e406a334b6dc50d343f7f81ff93f9e371.tar.lz nixpkgs-be4a0e6e406a334b6dc50d343f7f81ff93f9e371.tar.xz nixpkgs-be4a0e6e406a334b6dc50d343f7f81ff93f9e371.tar.zst nixpkgs-be4a0e6e406a334b6dc50d343f7f81ff93f9e371.zip |
Merge pull request #158605 from mweinelt/synapse-rfc42
nixos/matrix-synapse: migrate to rfc42 settings and formatter
Diffstat (limited to 'nixos/doc/manual/from_md/release-notes')
-rw-r--r-- | nixos/doc/manual/from_md/release-notes/rl-2205.section.xml | 110 |
1 files changed, 110 insertions, 0 deletions
diff --git a/nixos/doc/manual/from_md/release-notes/rl-2205.section.xml b/nixos/doc/manual/from_md/release-notes/rl-2205.section.xml index 2d8279725ff..4f4a5a3394e 100644 --- a/nixos/doc/manual/from_md/release-notes/rl-2205.section.xml +++ b/nixos/doc/manual/from_md/release-notes/rl-2205.section.xml @@ -390,6 +390,116 @@ </listitem> <listitem> <para> + The <literal>matrix-synapse</literal> service + (<literal>services.matrix-synapse</literal>) has been + converted to use the <literal>settings</literal> option + defined in RFC42. This means that options that are part of + your <literal>homeserver.yaml</literal> configuration, and + that were specified at the top-level of the module + (<literal>services.matrix-synapse</literal>) now need to be + moved into + <literal>services.matrix-synapse.settings</literal>. And while + not all options you may use are defined in there, they are + still supported, because you can set arbitrary values in this + freeform type. + </para> + <para> + An example to make the required migration clearer: + </para> + <para> + Before: + </para> + <programlisting language="bash"> +{ + services.matrix-synapse = { + enable = true; + + server_name = "example.com"; + public_baseurl = "https://example.com:8448"; + + enable_registration = false; + registration_shared_secret = "xohshaeyui8jic7uutuDogahkee3aehuaf6ei3Xouz4iicie5thie6nohNahceut"; + macaroon_secret_key = "xoo8eder9seivukaiPh1cheikohquuw8Yooreid0The4aifahth3Ou0aiShaiz4l"; + + tls_certificate_path = "/var/lib/acme/example.com/fullchain.pem"; + tls_certificate_path = "/var/lib/acme/example.com/fullchain.pem"; + + listeners = [ { + port = 8448; + bind_address = ""; + type = "http"; + tls = true; + resources = [ { + names = [ "client" ]; + compress = true; + } { + names = [ "federation" ]; + compress = false; + } ]; + } ]; + + }; +} +</programlisting> + <para> + After: + </para> + <programlisting language="bash"> +{ + services.matrix-synapse = { + enable = true; + + # this attribute set holds all values that go into your homeserver.yaml configuration + # See https://github.com/matrix-org/synapse/blob/develop/docs/sample_config.yaml for + # possible values. + settings = { + server_name = "example.com"; + public_baseurl = "https://example.com:8448"; + + enable_registration = false; + # pass `registration_shared_secret` and `macaroon_secret_key` via `extraConfigFiles` instead + + tls_certificate_path = "/var/lib/acme/example.com/fullchain.pem"; + tls_certificate_path = "/var/lib/acme/example.com/fullchain.pem"; + + listeners = [ { + port = 8448; + bind_address = [ + "::" + "0.0.0.0" + ]; + type = "http"; + tls = true; + resources = [ { + names = [ "client" ]; + compress = true; + } { + names = [ "federation" ]; + compress = false; + } ]; + } ]; + }; + + extraConfigFiles = [ + /run/keys/matrix-synapse/secrets.yaml + ]; + }; +} +</programlisting> + <para> + The secrets in your original config should be migrated into a + YAML file that is included via + <literal>extraConfigFiles</literal>. + </para> + <para> + Additionally a few option defaults have been synced up with + upstream default values, for example the + <literal>max_upload_size</literal> grew from + <literal>10M</literal> to <literal>50M</literal>. + </para> + </listitem> + <listitem> + <para> The MoinMoin wiki engine (<literal>services.moinmoin</literal>) has been removed, because Python 2 is being retired from nixpkgs. |