* Remove mention of Android Element X being less feature complete than iOS version Quoting upstream: > Element X Android and Element X iOS apps are in a similar state. > > https://github.com/vector-im/element-x-android/issues/911 * Update configuring-playbook-sliding-sync-proxy.md
3.3 KiB
Setting up Sliding Sync Proxy (optional)
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 is available on the Github Releases page.
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.
NOTE: The sliding-sync proxy is not required when using the Conduit homeserver. Starting from version 0.6.0
Conduit has native support for some sliding sync features. If there are issues with the native implementation, you might have a better experience when enabling the sliding-sync proxy anyway.
Decide on a domain and path
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.
Adjusting DNS records
If you've changed the default hostame, you may need to adjust your DNS records.
Adjusting the playbook configuration
Add the following configuration to your inventory/host_vars/matrix.DOMAIN/vars.yml
file:
matrix_sliding_sync_enabled: true
Installing
After potentially adjusting DNS records and configuring the playbook, run the installation command again: just install-all
.
External databases
Please note that, if your setup utilizes an external database, you must also establish configuration for the sliding sync proxy. Alter the defaults below to suit your configuration:
matrix_sliding_sync_database_username: 'matrix_sliding_sync'
matrix_sliding_sync_database_password: ''
matrix_sliding_sync_database_hostname: ''
matrix_sliding_sync_database_port: 5432
matrix_sliding_sync_database_name: 'matrix_sliding_sync'
Usage
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.