mautrix/telegram v0.2604.0

v26.04

on GitHub

Migration of SQLite databases has a known bug. If you're upgrading a legacy bridge that uses SQLite, use the main branch or wait for the next release

Release post: https://mau.fi/blog/2026-04-mautrix-release/

• Rewrote bridge in Go using bridgev2 architecture.
  • To migrate the bridge, simply upgrade in-place from v0.15.3 or later. The database and config will be migrated automatically, although some parts of the config aren't migrated (e.g. log config, permission types specific to the legacy bridge). Taking backups beforehand is always recommended.
  • It is recommended to check the config file after upgrading. If you have prevented the bridge from writing to the config, you should update it manually.
  • The old-style relaybot is not yet supported and will not be migrated. Setups using the relaybot will have to manually log in as a bot and use set-relay to enable the generic relay mode. The default_relays config option can be used to allow users to bridge chats through the relay user to emulate the old-style relaybot.
  • For multi-user bridges, normal (mini/non-super) group portal rooms are no longer shared, which means every Matrix user will have their own room. The old room will be assigned to one Matrix user randomly and others will get a new room created automatically when receiving a message in the chat or when using the !tg sync-chats command.
    • If you want shared portals, upgrade the affected groups to supergroups. You can upgrade groups using the !tg upgrade command, or in the official apps by enabling any setting that requires a supergroup (e.g. add a member tag for any admin).
  • Management room status will not be migrated. Use !tg set-management-room after the upgrade to re-allow commands without the !tg prefix in your private chat with the bridge bot.
  • Any migration issues should be reported in the Matrix room linked in the readme.
• Notable new features include:
  • Topic groups are now bridged as spaces
  • Entire sticker and emoji packs can be synced in both directions

Note: the last (unreleased) version of the legacy Python bridge is available in the python-final tag.