Deploy the official Matrix Stack helm chart #1

Closed
opened 2025-05-22 23:08:05 +00:00 by eric · 3 comments
Owner

There appears to be an official chart for the entire Matrix stack. Given some of the complications with the existing chart, it may be worth migrating to this one. Retaining data will be challenging but informative.

This is a duplicate of DevOps/ansible-role-eom#32.

There appears to be an official chart for the entire [Matrix stack](https://github.com/element-hq/ess-helm/tree/main). Given some of the complications with the existing chart, it may be worth migrating to this one. Retaining data will be challenging but informative. This is a duplicate of DevOps/ansible-role-eom#32.
eric added this to the 2025:Q2 milestone 2025-05-22 23:09:09 +00:00
eric changed title from Helm Chart to Deploy the official Matrix Stack helm chart 2025-05-24 02:07:17 +00:00
eric self-assigned this 2025-05-24 12:31:51 +00:00
eric started working 2025-05-24 21:04:42 +00:00
eric stopped working 2025-05-24 22:24:17 +00:00
1 hour 19 minutes
Author
Owner

Matrix Stack Helm Chart Configuration

Chapters

0:00:00 Intro
0:08:25 Matrix stack overview
0:18:53 Global configuration
0:36:45 MatrixRTC
0:45:51 Element Web
0:48:12 HAProxy
0:52:40 Matrix Authentication Service
0:58:50 PostgreSQL
1:03:50 Synapse
1:09:30 Well-known delegation
1:17:00 Outro

Summary

This live stream was hosted on Owncast and covers the initial configuration for the Matrix Stack Helm chart. An overview of the Matrix stack is provided, but for the most part, I am just going through the default values.yaml provided by the chart, populating important fields, and removing unnecessary ones. Having deployed Matrix previously through a different chart, I am thinking through options for migrating existing accounts, rooms, and spaces to the new deployment, though it may be necessary to start over with a fresh installation, which may also cause issues with existing federated chats. I am going to take some time to consider the best path forward before continuing.

# Matrix Stack Helm Chart Configuration <video controls type="video/mp4" src="https://minio.eom.dev/public/Videos/2025-05-24_17-00-52.mp4"></video> ## Chapters 0:00:00 Intro 0:08:25 Matrix stack overview 0:18:53 Global configuration 0:36:45 MatrixRTC 0:45:51 Element Web 0:48:12 HAProxy 0:52:40 Matrix Authentication Service 0:58:50 PostgreSQL 1:03:50 Synapse 1:09:30 Well-known delegation 1:17:00 Outro ## Summary This live stream was hosted on [Owncast](https://owncast.eom.dev) and covers the initial configuration for the Matrix Stack Helm chart. An overview of the Matrix stack is provided, but for the most part, I am just going through the default `values.yaml` provided by the chart, populating important fields, and removing unnecessary ones. Having deployed Matrix previously through a different chart, I am thinking through options for migrating existing accounts, rooms, and spaces to the new deployment, though it may be necessary to start over with a fresh installation, which may also cause issues with existing federated chats. I am going to take some time to consider the best path forward before continuing.
eric added spent time 2025-05-25 17:57:04 +00:00
30 minutes
eric started working 2025-05-25 17:57:09 +00:00
Author
Owner

Deploying Matrix Stack to Kubernetes

Chapters

00:00:00 Matrix Authentication Service Configuration
00:32:49 Deploying Matrix to Kubernetes
01:39:52 Reconfigure MAS
02:17:57 Debugging existing chats

Summary

In this live stream I am replacing my existing Matrix deployment with the configuration I began in the previous video. I add a few values for SMTP services and an upstream OAuth2 provider to enable SSO with Google. While SSO was successful, I had difficulty connecting with a user with whom I previously chatted due to my identity being reset. Upon further testing, I discovered I was also unable to join public Matrix spaces hosted on matrix.org. I suspect the federation key from the previous deployment needs to be recovered in order to reestablish these connections. Hopefully the previous key can be recovered from the Kubernetes PVC archive so that I can reconnect with other Matrix users.

# Deploying Matrix Stack to Kubernetes <video controls type="video/mp4" src="https://minio.eom.dev/public/Videos/2025-05-25_13-18-24.mp4"></video> ## Chapters 00:00:00 Matrix Authentication Service Configuration 00:32:49 Deploying Matrix to Kubernetes 01:39:52 Reconfigure MAS 02:17:57 Debugging existing chats ## Summary In this live stream I am replacing my existing Matrix deployment with the configuration I began in the previous video. I add a few values for SMTP services and an upstream OAuth2 provider to enable SSO with Google. While SSO was successful, I had difficulty connecting with a user with whom I previously chatted due to my identity being reset. Upon further testing, I discovered I was also unable to join public Matrix spaces hosted on matrix.org. I suspect the federation key from the previous deployment needs to be recovered in order to reestablish these connections. Hopefully the previous key can be recovered from the Kubernetes PVC archive so that I can reconnect with other Matrix users.
eric stopped working 2025-05-26 02:08:26 +00:00
8 hours 11 minutes
Author
Owner

Deployment is working and federated chats are behaving as expected as well (I suspect caching had something to do with the issue here). I am closing this issue and will open additional ones to address specific concerns on this platform.

Deployment is working and federated chats are behaving as expected as well (I suspect caching had something to do with the issue here). I am closing this issue and will open additional ones to address specific concerns on this platform.
eric closed this issue 2025-05-27 00:57:18 +00:00
Sign in to join this conversation.
No Label
No Milestone
No project
No Assignees
1 Participants
Notifications
Total Time Spent: 10 hours
eric
10 hours
Due Date
The due date is invalid or out of range. Please use the format 'yyyy-mm-dd'.

No due date set.

Dependencies

No dependencies set.

Reference: DevOps/ansible-role-matrix-stack#1
No description provided.