Join public alpha testing!

Release: Alpha.2

March 3, 2026

Introdcing business addresses support, fail-fast launch process and lazy file processing pipeline!

Overview

With this release we’re excited to present an early adoption of SimpleX business addresses! We tested only happy paths and we suspect that we missed a bunch of corner cases that may cause weird behaviours and bugs, afterall, supporting business addresses requires to use quite unstable SimpleX groups API. We count on you to report any problems and weirdnesses, make sure to checkout business address quirks before you get started!

We also took into account your feedback during alpha.1 and implemented a lot of safe-guards for the launch process to ensure that teleghosts launches in expected environment with correct arguments. See changelog for the full list of added checks.

The last big change in this release is a complete rewrite of the file processing pipeline. The new lazy pipeline downloads and processes attachments right before messages cross the bridge. Not only it guarantees to avoid unneseccary downloads it also makes features like process resumability and after-error recovery very easy to implement.

The next release will be focused on stability. We plan to implement graceful process shutdown and resumability and eliminate all errors that crash teleghosts today. Starting from the next release teleghosts will reliably deliver all encountered messages under all circumstances1

Join our SimpleX group for reporting bugs, getting help, providing suggestions, and participating in general discussion.

Changelog

  • Add support for business addresses
  • Ensure that SimpleX-CLI is compatible with teleghosts before starting it up
  • Ensure that --target address is valid contact address before connecting any bots to it
  • Admin bot throws error if connected to human profile in bot mirroring mode
  • Admin bot throws error if connected to bot profile in regular mode
  • Ensure that already connected contacts are reachable after SimpleX address removal (removing/changing your public address is still unsupported, this change just helps to support address updates in future versions)
  • New lazy file processing pipeline - blocked users can no longer spam instance with files
  • Hotfix.1: Add support for video and animated TG stickers
  • Append real file names to bridged Telegram messages with audio and document attachments
  • Downgrade attachments to regular documents instead of replacing them with errors when errors are not critical
  • Respect SimpleX profile preferences when sending media messages
  • Limit max amount of concurrent upload/download tasks to ensure that process consumes no more than 128MB of memory
  • Fix very rare occasions of corrupted attachments caused by unsynchronized concurrent file access
  • Fix user avatar not showing up for a long time after /contact_reconnect
  • Bridge username updates
  • Message refs are now regenerated instead of immediately throwing error on collision (practically impossible)
  • Hotfix.1: Fix delete_chat not removing business chats properly
  • Improve error messages
  • Fix typos
  • New lightweight stdout logger implementation for development purposes.

Release integrity verification

To verify the release you must have ssh-keygen installed

  1. Download the release and the corresponding .sig file from the Downloads section below
  2. Download the SSH allowed signers file
  3. Ensure that the downloaded allowed signers file matches the .gitsigners file located in the code repository
  4. Execute ssh-keygen -Y verify -n file -f ./allowed_signers -I teleghost-dev@nomail.brr -s teleghosts.sig < teleghosts

Downloads

chmod +x ./teleghosts after download

Hotfix.1

Ensure that ffmpeg binary is available in $PATH to see original video and animated Telegram stickers(replaced with corresponding emojis by default)

  1. unless host is unplugged from power-supply ↩︎