Authentication
- Open a private chat with the bridge bot. Usually
@gmessagesbot:your.server
- If the bot doesn't accept the invite, see the troubleshooting page
- Send
login
to start the login. - Log in by scanning the QR code. If the code expires before you scan it, the
bridge will send an error to notify you.
- On your phone, open
Messages by Google.
- Tap Menu
from your conversation list and select Device pairing.
- Tap QR code scanner and point your phone at the image sent by the bot.
- On your phone, open
- Finally, the bot should inform you of a successful login.
- If backfilling was enabled before logging in, portal rooms should start being created approximately a minute after login.
As all messages are proxied through the app, your phone must be connected to the internet for the bridge to work.
If you use Google Fi, note that the bridge does not support logging in with a Google account, so you must choose to use the normal QR login mode (option 1 in https://support.google.com/fi/answer/6188337).
Logging out
Simply run the logout
management command.