= matrix-synapse

image::https://img.shields.io/badge/Version-0.1.0-informational?style=flat-square[Version: 0.1.0]
image::https://img.shields.io/badge/Version-application-informational?style=flat-square[Type: application]
image::https://img.shields.io/badge/AppVersion-1.101.0-informational?style=flat-square[AppVersion: 1.101.0]
== Maintainers

.Maintainers
|===
| Name | Email | Url

| WrenIX
|
| <https://wrenix.eu>
|===

== Usage

Helm must be installed and setup to your kubernetes cluster to use the charts.
Refer to Helm's https://helm.sh/docs[documentation] to get started.
Once Helm has been set up correctly, fetch the charts as follows:

[source,bash]
----
helm pull oci://codeberg.org/wrenix/helm-charts/matrix-synapse
----

You can install a chart release using the following command:

[source,bash]
----
helm install matrix-synapse-release oci://codeberg.org/wrenix/helm-charts/matrix-synapse --values values.yaml
----

To uninstall a chart release use `helm`'s delete command:

[source,bash]
----
helm uninstall matrix-synapse-release
----

== Values

.Values
|===
| Key | Type | Default | Description

| config.bindAddresses
| list
| `["::"]`
| The bind addresses to use for the default listeners

| config.extraListeners
| list
| `[]`
|

| config.extraMainListenerTypes
| list
| `[]`
|

| config.reportStats
| bool
| `false`
|

| config.trustedKeyServers
| list
| `[{"server_name":"matrix.org"}]`
| A set of trusted servers to contact if another server doesn't respond to a signing key request.

| config.useStructuredLogging
| bool
| `false`
|

| externalPostgresql.database
| string
| `"synapse"`
|

| externalPostgresql.extraArgs
| object
| `{}`
| Extra arguments for the database connection ref: https://github.com/matrix-org/synapse/blob/develop/docs/postgres.md#synapse-config

| externalPostgresql.options
| object
| `{}`
| set extra configuration ref: https://github.com/matrix-org/synapse/blob/develop/docs/postgres.md#synapse-config e.g. txn_limit, allow_unsafe_locale

| externalPostgresql.port
| int
| `5432`
|

| externalPostgresql.username
| string
| `"synapse"`
|

| externalRedis.port
| int
| `6379`
|

| extraConfig
| object
| `{}`
|

| extraLoggers
| object
| `{}`
|

| extraSecrets
| object
| `{}`
|

| fullnameOverride
| string
| `nil`
| Override the full name of the installed chart.

| global.image.pullPolicy
| string
| `nil`
| if set it will overwrite all pullPolicy

| global.image.registry
| string
| `nil`
| if set it will overwrite all registry entries

| grafana.dashboards.annotations
| object
| `{}`
|

| grafana.dashboards.enabled
| bool
| `false`
|

| grafana.dashboards.labels.grafana_dashboard
| string
| `"1"`
|

| image.pullPolicy
| string
| `"IfNotPresent"`
|

| image.registry
| string
| `"ghcr.io"`
|

| image.repository
| string
| `"element-hq/synapse"`
|

| image.tag
| string
| `nil`
| Overrides the image tag whose default is the chart appVersion.

| ingress.annotations
| object
| `{}`
|

| ingress.csHosts
| list
| `[]`
|

| ingress.csPaths
| list
| `[]`
|

| ingress.enabled
| bool
| `true`
|

| ingress.hosts
| list
| `[]`
|

| ingress.includeServerName
| bool
| `true`
|

| ingress.includeUnderscoreSynapse
| bool
| `true`
|

| ingress.paths
| list
| `[]`
|

| ingress.tls
| list
| `[]`
|

| ingress.traefikPaths
| bool
| `false`
|

| ingress.wkHosts
| list
| `[]`
|

| nameOverride
| string
| `nil`
| Override part of the installed name, will still keep release name.

| persistence.accessMode
| string
| `"ReadWriteOnce"`
|

| persistence.annotations
| object
| `{}`
|

| persistence.enabled
| bool
| `true`
|

| persistence.existingClaim
| string
| `nil`
| A manually managed Persistent Volume and Claim Requires persistence.enabled: true If defined, PVC must be created manually before volume will be bound

| persistence.hostPath
| string
| `nil`
| Do not create an PVC, direct use hostPath in Pod

| persistence.size
| string
| `"10Gi"`
|

| persistence.storageClass
| string
| `nil`
| Persistent Volume Storage Class If defined, storageClassName: <storageClass> If set to "-", storageClassName: "", which disables dynamic provisioning If undefined (the default) or set to null, no storageClassName spec is   set, choosing the default provisioner.  (gp2 on AWS, standard on   GKE, AWS & OpenStack)

| postgresql.auth.database
| string
| `"synapse"`
|

| postgresql.auth.password
| string
| `"synapse"`
|

| postgresql.auth.username
| string
| `"synapse"`
|

| postgresql.enabled
| bool
| `true`
|

| postgresql.extraArgs
| object
| `{}`
| Extra arguments for the database connection ref: https://github.com/matrix-org/synapse/blob/develop/docs/postgres.md#synapse-config

| postgresql.options
| object
| `{}`
| set extra configuration ref: https://github.com/matrix-org/synapse/blob/develop/docs/postgres.md#synapse-config e.g. txn_limit, allow_unsafe_locale

| postgresql.primary.initdb.args
| string
| `"--lc-collate=C --lc-ctype=C"`
|

| postgresql.primary.persistence.size
| string
| `"16Gi"`
|

| prometheus.podmonitor.enabled
| bool
| `false`
|

| prometheus.podmonitor.labels
| object
| `{}`
|

| prometheus.rules.additionalRules
| list
| `[]`
|

| prometheus.rules.defaults.enabled
| bool
| `true`
|

| prometheus.rules.enabled
| bool
| `false`
|

| prometheus.rules.labels
| object
| `{}`
|

| publicServerName
| string
| `nil`
| The public Matrix server name, this will be used for any public URLs in config as well as for client API links in the ingress.

| redis.architecture
| string
| `"standalone"`
|

| redis.auth.enabled
| bool
| `true`
|

| redis.auth.password
| string
| `"synapse"`
|

| redis.enabled
| bool
| `true`
|

| redis.master.kind
| string
| `"Deployment"`
|

| redis.master.persistence.enabled
| bool
| `false`
|

| redis.master.service.port
| int
| `6379`
|

| serverName
| string
| `nil`
| The Matrix domain name, this is what will be used for the domain part in your MXIDs.

| service.port
| int
| `8008`
|

| service.targetPort
| string
| `"http"`
|

| service.type
| string
| `"ClusterIP"`
|

| serviceAccount.annotations
| object
| `{}`
|

| serviceAccount.create
| bool
| `false`
|

| signingkey.job.annotations
| object
| `{}`
|

| signingkey.job.enabled
| bool
| `true`
|

| signingkey.job.publishImage.pullPolicy
| string
| `"IfNotPresent"`
|

| signingkey.job.publishImage.registry
| string
| `"docker.io"`
|

| signingkey.job.publishImage.repository
| string
| `"bitnami/kubectl"`
|

| signingkey.job.publishImage.tag
| string
| `"latest"`
|

| signingkey.resources
| object
| `{}`
|

| synapse.affinity
| object
| `{}`
|

| synapse.annotations
| object
| `{}`
|

| synapse.extraCommands
| list
| `[]`
|

| synapse.extraEnv
| list
| `[]`
|

| synapse.extraVolumeMounts
| list
| `[]`
|

| synapse.extraVolumes
| list
| `[]`
|

| synapse.labels
| object
| `{}`
|

| synapse.livenessProbe.httpGet.path
| string
| `"/health"`
|

| synapse.livenessProbe.httpGet.port
| string
| `"http"`
|

| synapse.nodeSelector
| object
| `{}`
|

| synapse.podSecurityContext
| object
| `{}`
|

| synapse.readinessProbe.httpGet.path
| string
| `"/health"`
|

| synapse.readinessProbe.httpGet.port
| string
| `"http"`
|

| synapse.resources
| object
| `{}`
|

| synapse.securityContext
| object
| `{}`
|

| synapse.startupProbe.failureThreshold
| int
| `12`
|

| synapse.startupProbe.httpGet.path
| string
| `"/health"`
|

| synapse.startupProbe.httpGet.port
| string
| `"http"`
|

| synapse.strategy.type
| string
| `"RollingUpdate"`
|

| synapse.tolerations
| list
| `[]`
|

| volumePermissions.enabled
| bool
| `false`
|

| volumePermissions.gid
| int
| `666`
|

| volumePermissions.image.pullPolicy
| string
| `"Always"`
|

| volumePermissions.image.registry
| string
| `"docker.io"`
|

| volumePermissions.image.repository
| string
| `"library/alpine"`
|

| volumePermissions.image.tag
| string
| `"3.19.1"`
|

| volumePermissions.resources
| object
| `{}`
|

| volumePermissions.uid
| int
| `666`
|

| wellknown.affinity
| object
| `{}`
|

| wellknown.client
| object
| `{}`
| Data to serve on .well-known/matrix/client.  m.homeserver:    base_url: https://matrix.example.com

| wellknown.containerPort
| int
| `80`
|

| wellknown.enabled
| bool
| `false`
|

| wellknown.env
| list
| `[]`
|

| wellknown.image.pullPolicy
| string
| `"IfNotPresent"`
|

| wellknown.image.registry
| string
| `"docker.io"`
|

| wellknown.image.repository
| string
| `"library/nginx"`
|

| wellknown.image.tag
| string
| `"1.25.4"`
|

| wellknown.nodeSelector
| object
| `{}`
|

| wellknown.podAnnotations
| list
| `[]`
|

| wellknown.podLabels
| object
| `{}`
|

| wellknown.podSecurityContext
| object
| `{}`
|

| wellknown.replicaCount
| int
| `1`
|

| wellknown.resources
| object
| `{}`
|

| wellknown.securityContext
| object
| `{}`
|

| wellknown.server
| object
| `{}`
| The host and port combo to serve on .well-known/matrix/server.  m.server: matrix.example.com:443

| wellknown.service.annotations
| object
| `{}`
|

| wellknown.service.port
| int
| `8080`
|

| wellknown.service.type
| string
| `"ClusterIP"`
|

| wellknown.tolerations
| list
| `[]`
|

| workers.appservice.enabled
| bool
| `false`
|

| workers.appservice.generic
| bool
| `true`
|

| workers.appservice.name
| string
| `"appservices"`
|

| workers.default.affinity
| object
| `{}`
|

| workers.default.annotations
| object
| `{}`
|

| workers.default.extraCommands
| list
| `[]`
|

| workers.default.extraEnv
| list
| `[]`
|

| workers.default.livenessProbe.httpGet.path
| string
| `"/health"`
|

| workers.default.livenessProbe.httpGet.port
| string
| `"metrics"`
|

| workers.default.nodeSelector
| object
| `{}`
|

| workers.default.podSecurityContext
| object
| `{}`
|

| workers.default.readinessProbe.httpGet.path
| string
| `"/health"`
|

| workers.default.readinessProbe.httpGet.port
| string
| `"metrics"`
|

| workers.default.replicaCount
| int
| `1`
|

| workers.default.resources
| object
| `{}`
|

| workers.default.securityContext
| object
| `{}`
|

| workers.default.startupProbe.failureThreshold
| int
| `6`
|

| workers.default.startupProbe.httpGet.path
| string
| `"/health"`
|

| workers.default.startupProbe.httpGet.port
| string
| `"metrics"`
|

| workers.default.strategy.type
| string
| `"RollingUpdate"`
|

| workers.default.tolerations
| list
| `[]`
|

| workers.default.volumeMounts
| list
| `[]`
|

| workers.default.volumes
| list
| `[]`
|

| workers.federation_sender.enabled
| bool
| `false`
|

| workers.frontend_proxy.csPaths[0]
| string
| `"/_matrix/client/(api/v1|r0|v3|unstable)/keys/upload"`
|

| workers.frontend_proxy.enabled
| bool
| `false`
|

| workers.frontend_proxy.listeners[0]
| string
| `"client"`
|

| workers.generic_worker.csPaths[0]
| string
| `"/_matrix/client/(api/v1|r0|v3)/events$"`
|

| workers.generic_worker.csPaths[10]
| string
| `"/_matrix/client/(r0|v3|unstable)/account/3pid$"`
|

| workers.generic_worker.csPaths[11]
| string
| `"/_matrix/client/(r0|v3|unstable)/account/whoami$"`
|

| workers.generic_worker.csPaths[12]
| string
| `"/_matrix/client/(r0|v3|unstable)/devices$"`
|

| workers.generic_worker.csPaths[13]
| string
| `"/_matrix/client/versions$"`
|

| workers.generic_worker.csPaths[14]
| string
| `"/_matrix/client/(api/v1|r0|v3|unstable)/voip/turnServer$"`
|

| workers.generic_worker.csPaths[15]
| string
| `"/_matrix/client/(api/v1|r0|v3|unstable)/rooms/.*/event/"`
|

| workers.generic_worker.csPaths[16]
| string
| `"/_matrix/client/(api/v1|r0|v3|unstable)/joined_rooms$"`
|

| workers.generic_worker.csPaths[17]
| string
| `"/_matrix/client/(api/v1|r0|v3|unstable)/search$"`
|

| workers.generic_worker.csPaths[18]
| string
| `"/_matrix/client/(r0|v3|unstable)/keys/query$"`
|

| workers.generic_worker.csPaths[19]
| string
| `"/_matrix/client/(r0|v3|unstable)/keys/changes$"`
|

| workers.generic_worker.csPaths[1]
| string
| `"/_matrix/client/(api/v1|r0|v3|unstable)/createRoom$"`
|

| workers.generic_worker.csPaths[20]
| string
| `"/_matrix/client/(r0|v3|unstable)/keys/claim$"`
|

| workers.generic_worker.csPaths[21]
| string
| `"/_matrix/client/(r0|v3|unstable)/room_keys/"`
|

| workers.generic_worker.csPaths[22]
| string
| `"/_matrix/client/(api/v1|r0|v3|unstable)/login$"`
|

| workers.generic_worker.csPaths[23]
| string
| `"/_matrix/client/(r0|v3|unstable)/register$"`
|

| workers.generic_worker.csPaths[24]
| string
| `"/_matrix/client/v1/register/m.login.registration_token/validity$"`
|

| workers.generic_worker.csPaths[25]
| string
| `"/_matrix/client/(api/v1|r0|v3|unstable)/rooms/.*/redact"`
|

| workers.generic_worker.csPaths[26]
| string
| `"/_matrix/client/(api/v1|r0|v3|unstable)/rooms/.*/send"`
|

| workers.generic_worker.csPaths[27]
| string
| `"/_matrix/client/(api/v1|r0|v3|unstable)/rooms/.*/state/"`
|

| workers.generic_worker.csPaths[28]
| string
| `"/_matrix/client/(api/v1|r0|v3|unstable)/rooms/.*/(join|invite|leave|ban|unban|kick)$"`
|

| workers.generic_worker.csPaths[29]
| string
| `"/_matrix/client/(api/v1|r0|v3|unstable)/join/"`
|

| workers.generic_worker.csPaths[2]
| string
| `"/_matrix/client/(api/v1|r0|v3|unstable)/publicRooms$"`
|

| workers.generic_worker.csPaths[30]
| string
| `"/_matrix/client/(api/v1|r0|v3|unstable)/profile/"`
|

| workers.generic_worker.csPaths[31]
| string
| `"/_matrix/client/(r0|v3|unstable)/user_directory/search"`
|

| workers.generic_worker.csPaths[3]
| string
| `"/_matrix/client/(api/v1|r0|v3|unstable)/rooms/.*/joined_members$"`
|

| workers.generic_worker.csPaths[4]
| string
| `"/_matrix/client/(api/v1|r0|v3|unstable)/rooms/.*/context/"`
|

| workers.generic_worker.csPaths[5]
| string
| `"/_matrix/client/(api/v1|r0|v3|unstable)/rooms/.*/members$"`
|

| workers.generic_worker.csPaths[6]
| string
| `"/_matrix/client/(api/v1|r0|v3|unstable)/rooms/.*/state$"`
|

| workers.generic_worker.csPaths[7]
| string
| `"/_matrix/client/v1/rooms/.*/hierarchy$"`
|

| workers.generic_worker.csPaths[8]
| string
| `"/_matrix/client/unstable/org.matrix.msc2716/rooms/.*/batch_send$"`
|

| workers.generic_worker.csPaths[9]
| string
| `"/_matrix/client/unstable/im.nheko.summary/rooms/.*/summary$"`
|

| workers.generic_worker.enabled
| bool
| `false`
|

| workers.generic_worker.generic
| bool
| `true`
|

| workers.generic_worker.listeners[0]
| string
| `"client"`
|

| workers.generic_worker.listeners[1]
| string
| `"federation"`
|

| workers.generic_worker.paths[0]
| string
| `"/_matrix/federation/v1/event/"`
|

| workers.generic_worker.paths[10]
| string
| `"/_matrix/federation/(v1|v2)/send_leave/"`
|

| workers.generic_worker.paths[11]
| string
| `"/_matrix/federation/(v1|v2)/invite/"`
|

| workers.generic_worker.paths[12]
| string
| `"/_matrix/federation/v1/event_auth/"`
|

| workers.generic_worker.paths[13]
| string
| `"/_matrix/federation/v1/exchange_third_party_invite/"`
|

| workers.generic_worker.paths[14]
| string
| `"/_matrix/federation/v1/user/devices/"`
|

| workers.generic_worker.paths[15]
| string
| `"/_matrix/key/v2/query"`
|

| workers.generic_worker.paths[16]
| string
| `"/_matrix/federation/v1/hierarchy/"`
|

| workers.generic_worker.paths[17]
| string
| `"/_matrix/federation/v1/send/"`
|

| workers.generic_worker.paths[1]
| string
| `"/_matrix/federation/v1/state/"`
|

| workers.generic_worker.paths[2]
| string
| `"/_matrix/federation/v1/state_ids/"`
|

| workers.generic_worker.paths[3]
| string
| `"/_matrix/federation/v1/backfill/"`
|

| workers.generic_worker.paths[4]
| string
| `"/_matrix/federation/v1/get_missing_events/"`
|

| workers.generic_worker.paths[5]
| string
| `"/_matrix/federation/v1/publicRooms"`
|

| workers.generic_worker.paths[6]
| string
| `"/_matrix/federation/v1/query/"`
|

| workers.generic_worker.paths[7]
| string
| `"/_matrix/federation/v1/make_join/"`
|

| workers.generic_worker.paths[8]
| string
| `"/_matrix/federation/v1/make_leave/"`
|

| workers.generic_worker.paths[9]
| string
| `"/_matrix/federation/(v1|v2)/send_join/"`
|

| workers.media_repository.csPaths[0]
| string
| `"/_matrix/media/.*"`
|

| workers.media_repository.csPaths[1]
| string
| `"/_synapse/admin/v1/purge_media_cache$"`
|

| workers.media_repository.csPaths[2]
| string
| `"/_synapse/admin/v1/room/.*/media"`
|

| workers.media_repository.csPaths[3]
| string
| `"/_synapse/admin/v1/user/.*/media"`
|

| workers.media_repository.csPaths[4]
| string
| `"/_synapse/admin/v1/media/"`
|

| workers.media_repository.csPaths[5]
| string
| `"/_synapse/admin/v1/quarantine_media/"`
|

| workers.media_repository.csPaths[6]
| string
| `"/_synapse/admin/v1/users/.*/media$"`
|

| workers.media_repository.enabled
| bool
| `false`
|

| workers.media_repository.listeners[0]
| string
| `"media"`
|

| workers.media_repository.paths[0]
| string
| `"/_matrix/media/.*"`
|

| workers.pusher.enabled
| bool
| `false`
|

| workers.user_dir.csPaths[0]
| string
| `"/_matrix/client/(api/v1|r0|v3|unstable)/user_directory/search$"`
|

| workers.user_dir.enabled
| bool
| `false`
|

| workers.user_dir.listeners[0]
| string
| `"client"`
|

| workers.user_dir.name
| string
| `"userdir"`
|
|===

Autogenerated from chart metadata using https://github.com/norwoodj/helm-docs[helm-docs]