matrix-docker-ansible-deploy/docs/configuring-playbook-riot-web.md

Configuring Riot-web (optional)

By default, this playbook used to install the Riot-web Matrix client web application.

Riot has since been renamed to Element.

• to learn more about Element and its configuration, see our dedicated Configuring Element documentation page
• to learn how to migrate from Riot to Element, see Migrating to Element below

Migrating to Element

Migrating your custom settings

If you have custom matrix_riot_web_ variables in your inventory/host_vars/matrix.DOMAIN/vars.yml file, you’ll need to rename them (matrix_riot_web_ -> matrix_client_element_).

Domain migration

We used to set up Riot at the riot.DOMAIN domain. The playbook now sets up Element at element.DOMAIN by default.

There are a few options for handling this:

• (avoiding changes - using the old riot.DOMAIN domain and avoiding DNS changes) -- to keep using riot.DOMAIN instead of element.DOMAIN, override the domain at which the playbook serves Element: matrix_server_fqn_element: "riot.{{ matrix_domain }}"

• (embracing changes - using only element.DOMAIN) - set up the element.DOMAIN DNS record (see Configuring DNS). You can drop the riot.DOMAIN in this case. If so, you may also wish to remove old SSL certificates (rm -rf /matrix/ssl/live/riot.DOMAIN), so that certbot would stop trying to renew them.

• (embracing changes and transitioning smoothly - using both element.DOMAIN and riot.DOMAIN) - to serve Element at the new domain (element.DOMAIN) and to also have riot.DOMAIN redirect there - set up the element.DOMAIN DNS record (see Configuring DNS) and enable Riot to Element redirection (matrix_nginx_proxy_proxy_riot_compat_redirect_enabled: true).

Re-running the playbook

As always, after making the necessary DNS and configuration adjustments, re-run the playbook to apply the changes:

ansible-playbook -i inventory/hosts setup.yml --tags=setup-all,start