Releases: element-hq/ess-helm
25.12.2
ESS Community Helm Chart 25.12.2 (2025-12-19)
Security
-
Fix critical security issue tracked as
ELEMENTSEC-2025-1670.This release is a critical security update to address an issue affecting all versions of ESS Community and ESS Pro. ESS Classic and other Synapse-based deployments are not affected.
The issue only has an impact when federation APIs are exposed to an untrusted network. Deployments that are not currently federating, or that only federate in a closed, trusted federation, are not impacted. These deployments should not enable public federation without first applying this update.
We advise you to apply the update as quickly as possible. (#943)
25.12.1
ESS Community Helm Chart 25.12.1 (2025-12-12)
Removed / Breaking Changes
-
The MatrixRTC SFU now restricts creation of calls to users on the local homeserver.
This can be changed back to allowing anyone to create calls on the SFU by by setting
matrixRTC.restrictRoomCreationToLocalUsers: false. (#926)
Changed
-
Upgrade Synapse to v1.144.0.
Highlights:
- Add experimental implementation of MSC4380 (invite blocking).
- Allow the restarting delayed events endpoint for MatrixRTC to be served by workers.
Full Changelogs:
(#915)
-
Upgrade Matrix Authentication Service to v1.8.0.
Highlights:
- Add more options to deal with localpart conflicts on upstream OAuth 2.0 login.
- Option to skip confirmation when registering through an upstream OAuth provider.
Full Changelogs:
(#916)
-
Support configuring IPv4-only, IPv6-only or Dual-Stack component binds by configuring
networking.ipFamily.Defaults to
dual-stackbut if you are in a cluster where IPv6 support is either disabled at boot or compiled out you may need to set this toipv4(#921) -
Allow Synapse and Matrix Authentication Service to receive traffic over IPv6. (#921)
-
Removed some unused code from the
initSecretsgeneration container.Also complete the docs on the secret types it supports. (#927)
-
Upgrade Element Admin to v0.1.10.
Highlights :
- Fixed a crash in the moderation tab when the Adminbot endpoint is unavailable
- Added the ability to delete rooms
- Made the language switcher keyboard navigable
- Updated translations for better user experience
Full Changelogs:
(#932)
25.12.0
ESS Community Helm Chart 25.12.0 (2025-12-04)
Removed / Breaking Changes
-
Remove
imagePullSecretsin favour ofimage.pullSecrets.As of 25.10.1
imagePullSecretswas deprecated in favour ofimage.pullSecrets.
It has now been removed and attempting to useimagePullSecretswill trigger a schema
validation error. (#901) -
Remove the ability to set
rtc.{use_external_ip,node_ip}viamatrixRTC.sfu.additionalin favour ofmatrixRTC.sfu.{useStunToDiscoverPublicIP,manualIP}.As of 25.9.1
matrixRTC.sfu.{useStunToDiscoverPublicIP,manualIP}were introduced to provide direct values for these settings. Attempting to set
these viamatrixRTC.sfu.additionalwill result in your values being ignored. (#901)
Changed
-
Upgrade Element Web to v1.12.6.
Highlights:
- Remove mentions from forwarded messages.
- Improve aria attributes on the emoji picker.
- Support using Element Call for voice calls in DMs.
Full Changelogs:
-
Remove hard-coded
podAntiAffinityforDeploymentsthat had setreplicas > 2. (#867) -
Support
topologySpreadConstraintson all workloads, not just select ones. (#867) -
Set a soft, default
topologySpreadConstraintsfor all workloads.The can be removed by setting
topologySpreadConstraintsto[]at the top-level or
overridden on a per-component basis by setting that component'stopologySpreadConstraints. (#867) -
Unify management of
StatefulSet.specalong withDeployment.spec. (#872) -
Upgrade Synapse to v1.143.0.
Highlights:
- Update MSC4140 delayed event support, for separate endpoints.
Full Changelogs:
(#876)
-
Upgrade Matrix Authentication Service to v1.7.0.
Highlights:
- Interactively help users choosing a username.
Full Changelogs:
(#878)
-
Change Element Web and MatrixRTC SFU
Ingressesto targetServiceport names rather than numbers. (#879) -
Harmonise the hook weights and reduce the number of distinct hook weight values.
This should speed up installs and upgrades as now there are only 2 distinct pre-install/pre-upgrade hook weights. (#880)
-
Better handle the only worker-capable delayed-events endpoint. (#889)
-
Remove explicit configuration of HAProxy
maxconnat the global and backend level.This improves the compatibility with microk8s clusters that don't raise
ulimitsby default. (#890) -
Upgrade Element Admin to v0.1.9.
Highlights:
- Integration with the ESS Pro Adminbot
Full Changelogs:
(#900)
-
Listen for HAProxy traffic over IPv6. (#905)
-
Change
ipFamilyPolicytoPreferDualStackfor all services to expose them over dual-stack where possible. (#907) -
Change Matrix Authentication Service deployment
maxSurgeto 0.We have seen migrations race conditions happening during Matrix Authentication Service pods
rollout. This setsmaxSurgeto 0 to try to make sure only 1 pod at a time runs the
migration process. (#910, #914)
Fixed
- Change Postgres
emptyDirsto be memory backed. (#894) - Ensure Postgres is fully setup before marking as available or live. (#897)
- Fix Matrix Authentication Service secrets config generation so private keys coming from an external secret are correctly referenced. (#908)
Internal
- CI: switch from kind to k3d for integration tests. (#871)
- CI: simplify manifest test setup now that we care less about which deployables are in-use for a given values file. (#877)
- CI: add tests covering the weights and phases of Helm hooks. (#880, #884)
- Document why we don't use
passfilefor Synapse & MAS' Postgres configuration. (#881) - CI: Don't add New Vector Ltd copyright to new ci values files. (#882)
- CI: add concurrency limit per branch to prevent too many concurrent jobs. (#883)
- CI: validate that all
emptyDirsare memory backed. (#894) - CI: Make sure
init-secretsjob is not created when no secrets needs to be generated. (#896) - CI: Enhance manifests caching in manifests pytest runs. (#899)
- CI: Make cached manifests immutable to avoid issues where they might be mutated during test runs, causing races. (#899)
- CI: stop flakes in
test_pods_monitored. (#902) - CI: fix image verifications step failing on PRs on forks. (#909)
- CI: adjust expected status codes to retry on the upgrade integration tests. (#913)
25.11.1
ESS Community Helm Chart 25.11.1 (2025-11-14)
Changed
-
Upgrade Matrix Authentication Service to v1.6.0.
Highlights:
- Be strict about undefined variables in templates
Full Changelogs:
(#852)
-
Upgrade Synapse to v1.142.0.
Highlights:
- Add an Admin API to allow an admin to fetch the space/room hierarchy for a given space.
Full Changelogs:
(#853)
Internal
25.11.0
ESS Community Helm Chart 25.11.0 (2025-11-06)
Changed
-
Upgrade Element Web to v1.12.3.
Highlights:
- Fix sort order in space hierarchy.
- New Room list: don't display message preview of thread.
Full Changelogs:
(#842)
-
Re-add the chart's icon. (#848)
-
Update README. (#854)
-
Configure experimental MSC4143 advertisement in Synapse when MatrixRTC is enabled.
This is in addition to the MSC4143 advertisement on the client well-known endpoint for now, but it is expected to replace it in time. (#855)
-
Update Element Web's default bug report URL to use the dedicated subdomain for bug reporting. (#856)
Fixed
- Fix an issue where the chart could not be deployed against clusters returning an experimental build. (#850)
Documentation
- Document setting alternative STUN servers for MatrixRTC. (#851)
Internal
- CI: Use Element customised
pyhelm3dependency for running tests. (#848)
25.10.3
ESS Community Helm Chart 25.10.3 (2025-10-31)
Changed
-
Update
example-default-enabled-components-values.yamlto include MatrixRTC as it is enabled by default. (#516) -
Upgrade Element Web to v1.12.2.
Highlights:
- Improve handling of animated images.
- Fix duration of voice message in timeline.
- Improve keyboard navigation on invite dialog.
Full Changelogs:
(#809)
-
Update Element Admin to v0.1.8.
Highlights:
- Allow admins to generate personal access tokens for users
- Fix the ESS version not loading after a refresh
Full Changelogs:
-
Update Chart metadata to enhance tooling like
renovateandartifacthub.io. (#818) -
Update Synapse to v1.141.0.
Highlights:
- Update docker image to use Debian trixie as the base and thus Python 3.13
- Allow using MSC4190 behaviour without the opt-in registration flag
- Stabilize support for MSC4326: Device masquerading for appservices
Full Changelogs:
(#826)
-
Ensure there's at least 2 newlines at the end of the
haproxy.cfgfile. (#829) -
Upgrade Matrix Authentication Service to v1.5.0.
Highlights:
- Initial support for admins managing Personal Access Tokens for users using the Admin APIs.
Full Changelogs:
(#830)
-
Add 'Element Creations Ltd' copyright to every file. (#835)
Fixed
-
Postgres: Fix the ess-updater container do not have access to the local data directory. (#817)
-
Prioritize
wellKnownDelegation.baseDomainRedirect.urloverelementWeb.ingress.host.Previously, whenever elementWeb was enabled, the url property was silently ignored instead of, as expected, taking precedence. (#819)
-
Fix a Matrix compatible JSON response not being correctly sent when a Synapse backend is down. (#829)
Documentation
- Values Fragments: Make
serverNameunique to 1 fragment. (#806) - Matrix RTC: Document the SFU
CrashLoopBackOffissue. (#825)
Internal
- CI: New implementation of the configuration consistency checks. (#817, #831, #832, #833)
- CI: check that
matrix-toolscontainers only ever setargsand notcommand. (#820) - CI: check that all changed files have copyright notices for the new Element legal entity. (#822)
- Update SPDX check script to handle multiple Copyright headers. (#822, #835)
- Allow cloning of the source repository on Windows. (#827)
- Rename
Removedchangelog sections toRemoved / Breaking Changesand make more prominent. (#828) - CI: test that all multi-line config files end up in cluster with a trailing newline. (#829)
- CI: adapt integration test cluster creation for latest pytest-kubernetes. (#841)
25.10.2
ESS Community Helm Chart 25.10.2 (2025-10-16)
Security
-
Update Matrix Authentication Service to v1.4.1.
This is a security release which includes a fix for CVE-2025-62425 / GHSA-6wfp-jq3r-j9xh, which affects servers using the local password database, starting MAS 0.20.0 and later. See the advisory for details.
Full Changelogs:
(#813)
Changed
25.10.1
ESS Community Helm Chart 25.10.1 (2025-10-15)
Added
-
List deprecations in
NOTES.txtwhen runninghelm install/helm upgrade. (#796) -
Support overriding the default
imagePullPolicyfor every component by settingimage.pullPolicy.Per-image overrides can be set by setting
<path.to>.image.pullPolicyas before.If
image.pullPolicyor per-image overrides aren't setIfNotPresentis used by default for images
referenced by digest andAlwaysis used by default images referenced by tag as previously. (#798)
Changed
-
Update Matrix Authentication Service to v1.4.0.
Highlights:
- Make it possible to allow password registration without email verification.
- Add Admin API to finish individual sessions.
Full Changelogs:
(#787)
-
Ensure consistent captured headers in HAProxy log lines, between all HTTP request processing HAProxy frontends. (#788)
-
Correct the handling of multiple
X-Forwarded-Forheaders to Synapse.This may have exhibit itself as requests being incorrectly rate-limited by Synapse.
The source IP logged by HAProxy is now always the IP connecting to HAProxy rather than
a value extracted from theX-Forwarded-Forheader (if present). This is usually an IP
for the ingress controller. (#788) -
Log the
X-Forwarded-Forheader and stop logging theRefererheader in HAProxy. (#788) -
Upgrade HAProxy to 3.2.
Release notes:
(#790)
-
Upgrade Element Admin to v0.1.4.
Highlights:
- Use authenticated media endpoints for thumbnails
- Keep selected item when changing filters
Full Changelogs:
(#793)
-
Inform chart users, in
helm install/helm upgradenotes of the deprecations aroundrtc.{use_external_ip,node_ip}that happened in 25.9.1. (#796) -
Move the top-level
imagePullSecretslist toimage.pullSecrets.Setting
imagePullSecretsis deprecated and will be removed in 25.11. If you setimagePullSecretsin your values files, please migrate toimage.pullSecretsor you will see schema errors on upgrading to 25.11 when it is released. (#798) -
Upgrade Synapse to v1.140.0.
Highlights:
- Add a new Media Query by ID Admin API that allows server admins to query and investigate the metadata of local or cached remote media via the origin/media_id identifier found in a Matrix Content URI
- Add experimental implementation of the
GET /_matrix/client/v1/rtc/transportsendpoint for the latest draft of MSC4143: MatrixRTC
Full Changelogs:
(#799)
Fixed
- Fix templated
<component>.ingress.hostvalues not being rendered correctly inNOTES.txt. (#791) - Fix the Matrix RTC SFU not restarting when user-provided configuration is set via
matrixRTC.sfu.additional.<name>.config. (#805)
Internal
- CI: simplify the MatrixRTC integration test with Synapse + Well-Knowns. (#785)
- Ensure all
kubectlcommands inscripts/setup_test_cluster.shspecify the context. (#789) - CI: add a test that we don't have anything that looks like a template string in the rendered files. (#791)
- CI: check that all go files are formatted correctly as per
gofmt. (#792) - Run
gofmtovermatrix-tools. (#792) - CI: Use
poetry2.x. (#794) - CI: handle a user already existing in MAS across subsequent test runs. (#795)
- CI: recreate cached user access tokens when they're not valid (from a previous test run). (#795)
- CI: don't attempt to manage MAS user passwords if password login is disabled. (#795)
- CI: check that user-provided inline configuration changes a hash label on some workloads and thus restarts
Pods. (#805)
25.10.0
ESS Community Helm Chart 25.10.0 (2025-10-08)
Added
- Add a validation check to make sure no component is sharing any postgres database. (#778)
Changed
-
Update Element Web to v1.12.1.
Highlights:
- Update Message Sound for Element
- New Room List: Don't clear filters on space change
- Rich Text Editor: Add emoji suggestion support
Full Changelogs:
(#779)
-
Upgrade Synapse to v1.139.2.
Highlights:
- Fix
CVE-2025-61672/GHSA-fh66-fcv5-jjfr. Lack of validation for device keys in Synapse before 1.139.1 allows an attacker registered on the victim homeserver to degrade federation functionality, unpredictably breaking outbound federation to other homeservers.
Full Changelogs:
- Fix
Fixed
- Fix an issue where matrix-tools would fail to render configuration on containers restarts not causing a new pod cycle. (#771, #782)
Documentation
- Add initial troubleshooting guide around
MISSING_MATRIX_RTC_FOCUS. (#768)