|
1 | 1 | # Matrix Chart |
2 | 2 |
|
3 | | -A Helm chart for deploying a Matrix homeserver stack in Kubernetes. This is a fork of [Arkaniad/matrix-chart](https://github.com/Arkaniad/matrix-chart), which is a fork of [typokign/matrix-chart](https://github.com/typokign/matrix-chart). |
| 3 | +A Helm chart for deploying a Matrix homeserver stack in Kubernetes. This is a fork of [Arkaniad/matrix-chart](https://github.com/Arkaniad/matrix-chart), which is a fork of [typokign/matrix-chart](https://github.com/typokign/matrix-chart). |
4 | 4 |
|
5 | | -## Features |
| 5 | +## TLDR |
6 | 6 |
|
7 | | -- Latest version of [Synapse](https://github.com/matrix-org/synapse) |
8 | | -- Ingress definition for federated Synapse and Element |
| 7 | +See [charts/matrix/README.md](./charts/matrix/README.md) for docs auto-generated from the [`values.yaml`](./charts/matrix/values.yaml). |
| 8 | +Read through the parameters and modify them locally before installing the chart: |
| 9 | + |
| 10 | +```bash |
| 11 | +helm repo add matrix https://jessebot.github.io/matrix-chart |
| 12 | +helm install my-release-name matrix --values values.yaml |
| 13 | +``` |
| 14 | + |
| 15 | + |
| 16 | +## Current Features |
| 17 | + |
| 18 | +- Latest version of [Synapse](https://github.com/matrix-org/synapse) (the official homeserver edition of matrix) |
| 19 | +- Ingress definitions for federated Synapse (Matrix homeserver) and Element (frontend and CMS for matrix) |
| 20 | +- Use (existing) Kubernetes Secrets for confidential data, such as passwords |
| 21 | + |
| 22 | +### Optional Features |
9 | 23 |
|
10 | | -### Opptional Features |
11 | 24 | - Latest version of [Element](https://element.io/) |
| 25 | +- [Bitnami PostgreSQL subchart](https://github.com/bitnami/charts/tree/main/bitnami/postgresql) to deploy a cluster - needs some work to standardize though, so we also support external postgresql servers |
| 26 | + |
| 27 | +#### ⚠️ Optional Features (Untested Since Fork) |
| 28 | + |
| 29 | +These features still need to be tested, but are technically baked into the chart: |
12 | 30 | - Choice of lightweight Exim relay or external mail server for email notifications |
13 | | -- [Coturn TURN server sub-chart](https://github.com/jessebot/coturn-chart) for VoIP calls |
14 | | -- [Bitnami PostgreSQL sub-chart](https://github.com/bitnami/charts/tree/main/bitnami/postgresql) to deploy a cluster - needs some work to standardize though, so we also support external postgresql servers |
| 31 | +- [Coturn TURN server subchart](https://github.com/jessebot/coturn-chart) for VoIP calls |
| 32 | +- [Half-Shot/matrix-appservice-discord](https://github.com/Half-Shot/matrix-appservice-discord) Discord bridge |
15 | 33 | - [matrix-org/matrix-appservice-irc](https://github.com/matrix-org/matrix-appservice-irc) IRC bridge |
16 | 34 | - [tulir/mautrix-whatsapp](https://github.com/tulir/mautrix-whatsapp) WhatsApp bridge |
17 | | -- [Half-Shot/matrix-appservice-discord](https://github.com/Half-Shot/matrix-appservice-discord) Discord bridge |
18 | | - |
19 | | -## Installation |
20 | 35 |
|
21 | | -Some documentation is available in [`values.yaml`](./charts/matrix/values.yaml). See [charts/matrix/README.md](./charts/matrix/README.md) for docs auto-generated from the `values.yaml`. |
22 | 36 |
|
23 | | -### |
| 37 | +## Status |
| 38 | +This chart is now maintained mostly by me, @jessebot, but I'd love contributors as well! My goal is to provide regular updates using dependabot (maybe renovatebot soon) and provide some level of basic security from a k8s perspective. The aim as of right now has been removing any plaintext secrets and allowing for existing PVCs. I'm also trying to standardize the chart more by following predictable values.yaml patterns. |
24 | 39 |
|
25 | | -This is released normally, so you should be able to do: |
26 | | - |
27 | | -```bash |
28 | | -helm repo add matrix https://jessebot.github.io/matrix-chart |
29 | | -helm repo update |
30 | | -helm install my-release-name matrix |
31 | | -``` |
| 40 | +Note: I may stop supporting this if a larger entity maintains a better matrix chart (e.g. Bitnami releases a matrix helm chart), as then I'll just write PRs directly to them. At that time I'll put in a note in this README before publically archiving the repo. |
0 commit comments