matrix-docker-ansible-deploy/docs/configuring-playbook-riot-web.md
Suguru Hirahara b04b658735
Add "Web" to Element and SchildiChat web application (#3755)
* Replace "Element" with "Element Web"

- If Element indicates the web application, then it is changed to Element Web.
- If it indicates clients branded with Element such as Element desktop, web, mobile clients, then it is changed to Element clients.
- If it is combined with location sharing functionality, it is not changed.

with other some changes, including:

- Change "app.element.io" anchor link to "https://github.com/element-hq/element-web" on README.md, following other documentation files

Signed-off-by: Suguru Hirahara <acioustick@noreply.codeberg.org>

* Replace "SchildiChat" with "SchildiChat Web"

- If SchildiChat indicates the web application, then it is changed to SchildiChat Web.
- If it indicates clients branded with SchildiChat such as SchildiChat desktop, web, mobile clients, then it is changed to SchildiChat clients.
- If it is combined with location sharing functionality, it is not changed.

Signed-off-by: Suguru Hirahara <acioustick@noreply.codeberg.org>

* Rename configuring-playbook-client-schildichat.md to configuring-playbook-client-schildichat-web.md

Signed-off-by: Suguru Hirahara <acioustick@noreply.codeberg.org>

* Rename configuring-playbook-client-element.md to configuring-playbook-client-element-web.md

Signed-off-by: Suguru Hirahara <acioustick@noreply.codeberg.org>

---------

Signed-off-by: Suguru Hirahara <acioustick@noreply.codeberg.org>
Co-authored-by: Suguru Hirahara <acioustick@noreply.codeberg.org>
2024-11-07 16:31:26 +02:00

1.8 KiB

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.

Migrating to Element Web

Migrating your custom settings

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

Some other playbook variables (but not all) with riot in their name are also renamed. The playbook checks and warns if you are using the old name for some commonly used ones.

Domain migration

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

There are a few options for handling this:

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

  • (embracing changes - using only element.example.com) - set up the element.example.com DNS record (see Configuring DNS). You can drop the riot.example.com in this case.

Re-running the playbook

After configuring the playbook, run the installation command: just install-all or just setup-all