Home YunoHost Logo
Logo for Matrix-WhatsApp bridge

Matrix-WhatsApp bridge


Current version: 0.10.7~ynh1

Potential alternative to: Whatsapp

A puppeting bridge between Matrix and WhatsApp packaged as a YunoHost service. Messages, media and notifications are bridged between a WhatsApp user and a matrix user. With the RelayBot login option, the matrix user can invite other matrix user in a bridged WhatsApp room, such that even people without a WhatsApp account can participate to WhatsApp group conversations. The "Mautrix-WhatsApp" bridge consists in a synapse app service and relies on postgresql (mysql also available). Therefore, Synapse for YunoHost should be installed beforehand.

** Attention: always backup and restore the Yunohost matrix_synapse et mautrix_whatsapp apps together!**

This app is only compatible with these specific architectures: amd64, arm64, armhf

Important infos before installing

Multi-user support

  • Bot users are not related to Yunohost users. Any Matrix account or Synapse server autorized in the configuration of the bridge can invite/use the bot.
  • The WhatsApp bot is a local Matrix-Synapse user, but accessible through federation (synapse public or private).
  • Several WhatsApp and Matrix users can be bridged with one bridge, each user has its own bot administration room.
  • If several bot users are in a same WhatsApp group, only one Matrix room will be created by the bridge.
  • See https://github.com/YunoHost-Apps/synapse_ynh#multi-users-support


  • Audio/Video calls are not bridged yet.
  • If WhatsApp loses connection, e.g. the phone is set in flight mode or push notifications are deactivated, the bot has sometimes to be restarted manually by sending !wa reconnnect in the Matrix administration room.
  • WhatsApp needs to get presence from the official app every two weeks at least, so bridge will send a reminder in the administration room.

Additional information

echo | openssl s_client -showcerts -servername synapse.vm -connect synapse.vm:443 2>/dev/null | awk '/-----BEGIN CERTIFICATE-----/, /-----END CERTIFICATE-----/' >> /usr/local/share/ca-certificates/synapse.vm.crt

Miscellaneous information

  • Matrix room (matrix bridges in YunoHost): #mautrix_yunohost:matrix.fdn.fr
  • Matrix room (upstream app): #whatsapp:maunium.net In case you need to upload your logs somewhere, be aware that they contain your contacts and your phone numbers. Strip them out with: | sed -r 's/[0-9]{10,}/📞/g'
  • "Mautrix-WhatsApp" bridge is based on the Rhymen/go-whatsapp implementation of the sigalor/whatsapp-web-reveng project.

Useful links

App license: AGPL-3.0-or-later Official website Official admin documentation Official code repository YunoHost package repository YunoHost package license