The format is as follows:

        listeners:
          - port: 8448
            bind_address: ''
            type: http

            tls: false

            resources:
              - names: [client, webclient]
                compress: true
              - names: [federation]
                compress: false

          - port: 8008
            bind_address: ''
            type: http

            tls: true
            x_forwarded: False

            resources:
              - names: [client, webclient]
                compress: true
              - names: [federation]
                compress: false

          - port: 9000
            bind_address: ''
            type: manhole

The current recognized types are http and manhole.

The recognized resources for http are:

• static - static resources, e.g. registration fallback
• media - media repository
• keys - key server
• client - client APIs, both v1 and v2 ⇒ static and media
• federation - federation API ⇒ keys and media
• webclient - hosted webclient
• metrics - metrics API

TODO:

• Initial Implementation.
• Backwards compat with existing format.
• Compression on a per listener basis
• Support X-Forwarded-For on a per listener basis.
• Annotate default config with documentation.
• [ ] Fully document the listener options somewhere.
• [ ] Deprecate existing config options. Warn on start up if they're used?