Skip to main content

EMS Knowledge Base

The knowledge base for all Element Matrix Services provided products.

I can't upload files after updating to 0.6.1

Issue Can no longer upload files after upgrading my PoC environment to 0.6.1. Environment Ubun...

synapse-haproxy container in CrashLoopBackOff state

Issue We are seeing [karl1@element ~]$ kubectl get pods -n element-onprem NAME ...

Can't connect to local registry 127.0.0.1:32000

Issue Getting a connection refused when trying to upload images to the local registtry. "ms...

Installer fails with AnsibleUnsafeText object has no attribute 'addons'

Issue The installer fails with this error message: TASK [microk8s : convert from list to dict] ...

How to Setup Local Host Resolution Without DNS

Overview In an Element Enterprise On-Premise environment, hostnames must resolve to the appropria...

How to Upgrade microk8s for Single Node Installations

microk8s in Single Node Installations For Element On-Premise and Element Enterprise On-Premise, w...

After upgrading to 1.0.0, postgres-0 is in CrashLoopBackOff state

Issue I upgraded my environment from 0.6.1 to 1.0.0 and now postgres-0 is in CrashLoopBackOff s...

Integrator fails with Unable to initialise application. Failed to validate config: data/jitsi_domain must match format "hostname"...

Issue After installing integrator and browsing to it by hostname, I get the following error: Un...

Installer fails looking for join_local_rooms_only

Issue When updating my existing Element On-Premise instance, the installer fails with: 2022-10-...

Hookshot fails to display configuration widget

Issue While trying to load the hookshot configuration widget, I get: Error occured during widget...

Installer hangs on "microk8s : Wait for microk8s to be ready" task

Issue The installer is hanging at this step: 2022-10-20 18:41:25,994 p=304 u=element-user n=ansi...

After an install, I only have the postgres-0 pod!

Issue After installing Element On-Premise, I only have a postgres-0 in the element-onprem names...

Using Self-Signed Certificates with mkcert

Overview We do not recommend using self-signed certificates with Element Enterprise On-Premise, h...

Installer fails on firewalld, but firewalld is not installed

Issue I'm seeing this with the installer, but I don't have firewalld installed: 2022-08-15 15:52:...

Pip cache errors

Issue The installer is failing at the pip stage with such kind of error message: Collecting pycp...

What Telemetry Data is Collected by Element?

Issue Element collects telemetry data to understand whether or not customers are in compliance w...

Getting a 502 Bad Gateway Error When Accessing Element Web

Issue We are getting a 502 Bad Gateway Error from nginx when accessing Element Web. Environment...

Configuring a microk8s Single Node Instance to Use a Network Proxy

Overview If you are using the microk8s Single Node Installer and your site requires proxy access ...

Installer 2022-08.01 fails to pull element web into the cluster

Issue After running the setup, the element web pod is stuck in ImagePullBackoff Environment E...

url.js:354 error starting dimension

Issue I'm getting the following error trying to start dimension: Starting matrix-dimension url....

Installer fails on enabling addons

Issue The installer is stating that it's failed and I'm seeing messages like: skipping: [localhos...

I'd like to turn off federation

Issue Need to turn off federation, which is on by default. Environment Element On-Premise Inst...

How do I migrate to SSO while keeping my original accounts?

Issue When having previously used Matrix without SSO, after setting up SSO, new matrix accounts ...

How do I give a user admin rights when I am using delegated authentication and cannot log into the admin console?

Issue I am trying to log into the admin console, but cannot log in with the provided onprem-admi...

How do I run the installer without using the GUI?

Issue I need to be able to automate my install with configuration files and an unattended instal...

Verifying Well Known CORS Headers

Issue Specifying a homeserver using Well Known delegation but without CORS headers results in an...

Submitting Telemetry Data to Element

Issue I am unable to allow Element's telemetry upload to take place and need to submit my teleme...

What data should I collect when I have an issue?

Issue I'm having an issue with Element's on premise server suite and need to know what data to c...

I need a new token!

Issue I lost my EMS token and now I can't set up new installations. Environment Element Server...

module 'jsonschema._utils' has no attribute 'load_schema'

Issue On-Premise installer fails to install with error: module 'jsonschema._utils' has no attrib...

Kubernetes internal certificates have expired

Issue Errors within cluster relating to expired Kubernetes internal certificates, i.e. E0830 12:...

Setting up Delegated Authentication with SAML on Microsoft Azure

Before setting up the installer, you have to configure Microsoft Entra ID. Set up Microsoft Entra...

The Secure Border Gateway

The Secure Border Gateway (SBG) is an HTTP proxy designed to filter and analyze Matrix traffic be...

Using ESS with a local registry in air-gapped networks

Issue In some air-gapped environments, rather than downloading the air-gapped artifacts from the...

Testing Dehydrated Devices

Enabling Dehydrated Devices Support To enable the dehydrated devices feature Element Server Suite...