Files
ess-helm/charts/matrix-stack

Matrix Stack Chart

This Helm chart deploys a coherent Matrix Stack. It currently includes the following components

Synapse

A minimal set of values to bring up Synapse would be

serverName: ess.localhost

synapse:
  ingress:
    host: synapse.ess.localhost

  registrationSharedSecret:
    value: A Secret
  macaroon:
    value: Another Secret
  signingKey:
    value: ed25519 0 bNQOzBUDszff7Ax81z6w0uZ1IPWoxYaazT7emaZEfpw

  postgres:
    host: ess-postgres
    user: synapse_user
    database: synapse
    password:
      secret: ess-postgres
      secretKey: password

The 4 credentials shown can either be provided inline in the values with value or if you have an existing Secret in the cluster in the same namespace you can use secret and secretKey to reference it. Signing keys

serverName is the value that is embedded in user IDs, room IDs, etc. It can't be changed after the initial deployment and so should be chosen carefully. If federating https://<serverName>/.well-known/matrix/server must be available and contain the location of this Synapse. Future versions of this chart will do this for you.

Additional Synapse configuration can be provided inline in the values as a string with

synapse:
  additional:
    config: |
      admin_contact: "mailto:[email protected]"

or referencing an existing Secret by:

synapse:
  additional:
    configSecret: custom-synapse-config
    configSecretKey: shared.yaml

Full details on available configuration options can be found at https://element-hq.github.io/synapse/latest/usage/configuration/config_documentation.html

Synapse is enabled for deployment by default can be disabled with the following values

synapse:
  enabled: false

Other settings for Synapse can be seen under the synapse section of helm show values for this chart.

Element Web

A minimal set of values to bring up Element Web would be

elementWeb:
  ingress:
    host: element.ess.localhost

If serverName is set this will be configured in Element Web. If Synapse is enabled this will be configured in Element Web as well.

Additional Element Web configuration can be provided as arbitrary sub-properties with

elementWeb:
  additional:
    default_theme: dark
    default_server_config:
      m.identity_server:
        base_url: https://vector.im

Full details on available configuration options can be found at https://github.com/element-hq/element-web/blob/develop/docs/config.md.

Element Web is enabled for deployment by default can be disabled with the following values

elementWeb:
  enabled: false

Other settings for Element Web can be seen under the elementWeb section of helm show values for this chart.

Well Known Delegation

A minimal set of values to bring up Well Known Delegation would be

servername: ess.localhost

If Synapse is enabled, its ingress host will be configured in Well Known Delegation config file as well.

Additional Well Known Delegation configuration can be provided as arbitrary sub-properties with

wellKnownDelegation:
  additional:
    server: |
      {"some": "config"}
    client: |
      {"some": "config"}
    element: |
      {"some": "config"}

Well Known Delegation is enabled for deployment by default can be disabled with the following values

wellKnownDelegation:
  enabled: false

Other settings for Well Known Delegation can be seen under the wellKnownDelegation section of helm show values for this chart.