matrix-docker-ansible-deploy/docs/configuring-playbook-bridge-mautrix-wsproxy.md
Suguru Hirahara 282e8be07d
Use common sentences on documentation regarding installation
Signed-off-by: Suguru Hirahara <acioustick@noreply.codeberg.org>
2024-10-13 03:38:48 +09:00

1.5 KiB

Setting up Mautrix wsproxy (optional)

The playbook can install and configure mautrix-wsproxy for you.

See the project's documentation to learn what it does and why it might be useful to you.

DNS

You need to create a wsproxy.DOMAIN DNS record pointing to your Matrix server (a CNAME pointing to matrix.DOMAIN) to use wsproxy. The hostname is configurable via a matrix_mautrix_wsproxy_hostname variable.

Adjusting the playbook configuration

To enable the bridge, add the following configuration to your inventory/host_vars/matrix.DOMAIN/vars.yml file:

matrix_mautrix_wsproxy_enabled: true

matrix_mautrix_androidsms_appservice_token: 'secret token from bridge'
matrix_mautrix_androidsms_homeserver_token: 'secret token from bridge'
matrix_mautrix_imessage_appservice_token: 'secret token from bridge'
matrix_mautrix_imessage_homeserver_token: 'secret token from bridge'
matrix_mautrix_wsproxy_syncproxy_shared_secret: 'secret token from bridge'

Note that the tokens must match what is compiled into the mautrix-imessage bridge running on your Mac or Android device.

Installing

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

Usage

Follow the matrix-imessage documenation for running android-sms and/or matrix-imessage on your device(s).