2020-06-05 19:52:24 +08:00
# Setting up matrix-sms-bridge (optional)
2020-05-23 19:14:24 +08:00
The playbook can install and configure
2020-06-05 19:52:24 +08:00
[matrix-sms-bridge ](https://github.com/benkuly/matrix-sms-bridge ) for you.
2020-05-23 19:14:24 +08:00
See the project page to learn what it does and why it might be useful to you.
2020-06-02 14:39:30 +08:00
First you need to ensure, that the bridge has unix read and write rights to your modem. On debian based distributions there is nothing to do. On others distributions you either add a group `dialout` to your host and assign it to your modem or you give the matrix user or group access to your modem.
2020-05-23 19:14:24 +08:00
To enable the bridge just use the following
playbook configuration:
```yaml
matrix_sms_bridge_enabled: true
2020-06-03 00:27:33 +08:00
matrix_sms_bridge_gammu_modem: "/dev/serial/by-id/myDeviceId"
2020-05-23 19:14:24 +08:00
# generate a secret passwort e.g. with pwgen -s 64 1
matrix_sms_bridge_database_password: ""
# (optional) a room id to a default room
2020-06-02 20:56:22 +08:00
matrix_sms_bridge_default_room: ""
2020-06-06 14:28:08 +08:00
# (optional) gammu reset frequencies (see https://wammu.eu/docs/manual/smsd/config.html#option-ResetFrequency)
2020-06-02 20:56:22 +08:00
matrix_sms_bridge_gammu_reset_frequency: 3600
2020-06-06 14:28:08 +08:00
matrix_sms_bridge_gammu_hard_reset_frequency: 0
2020-06-02 14:39:30 +08:00
# (optional) group with unix read and write rights to modem
matrix_sms_bridge_modem_group: 'dialout'
2020-05-23 19:14:24 +08:00
```
## Usage
Read the [user guide ](https://github.com/benkuly/matrix-sms-bridge/blob/master/README.md#user-guide ) to see how this bridge works.
