The playbook can install and configure sliding-sync proxy for you.
Sliding Sync is an implementation of MSC3575 and a prerequisite for running the new (still beta) Element X clients (Element X iOS and Element X Android).
See the project's documentation to learn more.
Element X iOS is available on TestFlight.
Element X Android requires manual compilation to get it working with a non-matrix.org
homeseserver. It's also less feature-complete than the iOS version.
NOTE: The Sliding Sync proxy only works with the Traefik reverse-proxy. If you have an old server installation (from the time matrix-nginx-proxy
was our default reverse-proxy - matrix_playbook_reverse_proxy_type: playbook-managed-nginx
), you won't be able to use Sliding Sync.
By default, the Sliding Sync proxy is configured to be served on the Matrix domain (matrix.DOMAIN
, controlled by matrix_server_fqn_matrix
), under the /sliding-sync
path.
This makes it easy to set it up, without having to adjust your DNS records.
If you'd like to run the Sliding Sync proxy on another hostname or path, use the matrix_sliding_sync_hostname
and matrix_sliding_sync_path_prefix
variables.
If you've changed the default hostame, you may need to adjust your DNS records.
Add the following configuration to your inventory/host_vars/matrix.DOMAIN/vars.yml
file:
matrix_sliding_sync_enabled: true
After potentially adjusting DNS records and configuring the playbook, run the installation command again: just install-all
.
You don't need to do anything special to make use of the Sliding Sync Proxy. Simply open your client which supports Sliding Sync (like Element X) and log in.
When the Sliding Sync proxy is installed, your /.well-known/matrix/client
file is also updated. A new org.matrix.msc3575.proxy
section and url
property are added there and made to point to your Sliding Sync proxy's base URL (e.g. https://matrix.DOMAIN/sliding-sync
).
This allows clients which support Sliding Sync to detect the Sliding Sync Proxy's URL and make use of it.