Skip to content

Latest commit

 

History

History
86 lines (70 loc) · 2.29 KB

configure.md

File metadata and controls

86 lines (70 loc) · 2.29 KB
Raw

Configuration

Concepts

Syntax

The configuration file is YAML based:

my:
  config:
    item: 'value'

When referencing keys in all documents, a property-like shorthand will be used. The shorthand for the above example would be my.config.item

Matrix

matrix.domain Matrix domain name, same as the Homeserver, used to build appropriate Matrix IDs |

matrix.identity.servers Namespace to create arbitrary list of Identity servers, usable in other parts of the configuration |

Example:

matrix:
  identity:
    servers:
      myOtherServers:
        - 'https://other1.example.org'
        - 'https://other2.example.org'

Create a list under the label myOtherServers containing two Identity servers: https://other1.example.org and https://other2.example.org.

Server

  • server.name: Public hostname of mxisd, if different from the Matrix domain.
  • server.port: HTTP port to listen on (unencrypted)
  • server.publicUrl: Defaults to https://{server.name}

Storage

SQLite

storage.provider.sqlite.database: Absolute location of the SQLite database

Identity stores

See the Identity stores for specific configuration

3PID Validation sessions

See the dedicated documents:

Notifications

  • notification.handler.<3PID medium>: Handler to use for the given 3PID medium. Repeatable.

Example:

notification:
  handler:
    email: 'sendgrid'
    msisdn: 'raw'
  • Emails notifications would use the sendgrid handler, which define its own configuration under notification.handlers.sendgrid
  • Phone notification would use the raw handler, basic default built-in handler in mxisd

Handlers

  • notification.handers.<handler ID>: Handler-specific configuration for the given handler ID. Repeatable.

Example:

notification:
  handlers:
    raw: ...
    sendgrid: ...

Built-in: