Server to server (S2S): [[listen.s2s]]

Handles incoming server-to-server (S2S) connections (federation). The recommended port number for an S2S listener is 5269 as registered in the XMPP protocol.

Note

Many S2S options are configured in the s2s section of the configuration file, and they apply to both incoming and outgoing connections.

Configuration options

For each S2S listener, all the general and XMPP options are accepted.

Additionally, to enable TLS, a TOML subsection called tls has to be present in the listener options. To disable TLS, make sure that the section is not present, and no TLS options are set. You can specify additional options of the TLS encryption in the tls subsection. They have the same semantics as the corresponding c2s options.

S2S listener configuration example

The following section configures an S2S listener with some basic settings set up. The fast shaper is used, which requires a definition in the shaper section (the default configuration file includes it).

[[listen.s2s]]
  port = 5269
  shaper = "fast"
  max_stanza_size = 131072
  tls.dhfile = "dh_server.pem"