# Proton Mail Bridge changelog > Use Proton Mail with any desktop mail client. - Vendor: Proton - Category: Communication - Platforms: Desktop - Official site: https://proton.me/mail/bridge - Tracked by: What's New (https://whatsnew.fyi/product/proton-mail-bridge) - Harvested from: GitHub (ProtonMail/proton-bridge) - Entries below: 10 (newest first) What's New is an index, not a publisher: every entry below links to the vendor's own release notes, which are the authoritative source. Entries are labelled where they are hand-curated sample data, pre-releases, or drawn from a secondary source such as a developer blog. ## Releases ### v3.25.0 — Bridge Oberbaum v3.25.0 - Date: 2026-06-01 - Version: v3.25.0 - Original notes: https://github.com/ProtonMail/proton-bridge/releases/tag/v3.25.0 - Permalink: https://whatsnew.fyi/product/proton-mail-bridge/releases/v3.25.0 - Labels: Platforms: Desktop - **added** — Include recipients address in an error-mapped error - **added** — Include the full error-chain when an update fails to install - **added** — Map NoSuchUser error to a user friendly message - **changed** — Replace usage of exp/maps with maps from standard library - **changed** — Bump Go toolchain to 1.26.2 - **changed** — Map API validation errors to a more user-friendly error - **changed** — Remove old legacy versioner utility and legacy updater logic - **changed** — Remove stale feature flags - **changed** — Patch vulnerabilities for March 2026 - **changed** — Modify message building MIME boundary generation logic - **fixed** — Change Local Cache to use QFileDialog instead of Qt.Quick Folder Dialog - **fixed** — Fix runtime index out of bounds error during build stage - **fixed** — Replace old go syntax using go:fix to match new go 1.26 syntax - **fixed** — Update dependencies and update deprecated functions - **fixed** — Sanitize attachment filenames in user debug mode - **fixed** — Remove temporary directory after update installation on macOS - **fixed** — Correct error value gets logged when building a RFC822 message ###### Added * BRIDGE-519: Include recipients address in an errormapped error. * BRIDGE-547: Automatically retry failing tests on CI. * BRIDGE-511: Include the full error-chain when an update fails to install. * BRIDGE-139: New test that checks the validity of KB article URLs. * BRIDGE-531: New modernize linter and CI go:fix piplines added. * BRIDGE-559: NoSuchUser error gets mapped to a user friendly message. ###### Changed * BRIDGE-534: Usage of exp/maps replaced with maps from standard library. * BRIDGE-526: Go toolchain bump to 1.26.2. * BRIDGE-514: Map API validation errors to a more user-friendly error. * BRIDGE-528: Removed old legacy versioner utility & legacy updater logic. * BRIDGE-486: Removed stale feature flags. * BRIDGE-483: Patch vulnerabilities for March 2026. * BRIDGE-548: Modify message building MIME boundary generation logic (stochastic). ###### Fixed * BRIDGE-557: Change Local Cache uses QFileDialog instead of Qt.Quick Folder Dialog. * BRIDGE-540: Runtime index out of bounds error during build stage. * BRIDGE-515: Replace old go syntax using go:fix to match new go 1.26 syntax. * BRIDGE-503: Dependencies update and updated deprecated functions. * BRIDGE-512: Attachment filenames are sanitized in user debug mode. * BRIDGE-415: Remove temporary directory after update installation on macOS. * BRIDGE-499: Correct error value gets logged when building a RFC822 message. ### v3.24.2 — Bridge Nescio v3.24.2 - Date: 2026-04-20 - Version: v3.24.2 - Original notes: https://github.com/ProtonMail/proton-bridge/releases/tag/v3.24.2 - Permalink: https://whatsnew.fyi/product/proton-mail-bridge/releases/v3.24.2 - Labels: Platforms: Desktop ###### Changed * BRIDGE-535: Use new base golang version based on Debian Bullseye. ### v3.24.1 — Bridge Nescio v3.24.1 - Date: 2026-04-08 - Version: v3.24.1 - Original notes: https://github.com/ProtonMail/proton-bridge/releases/tag/v3.24.1 - Permalink: https://whatsnew.fyi/product/proton-mail-bridge/releases/v3.24.1 - Labels: Platforms: Desktop - **changed** — Restored old unlabel endpoint logic under a feature flag ###### Changed * BRIDGE-522: Restored old unlabel endpoint logic under a feature flag. ### v3.24.0 — Bridge Nescio v3.24.0 - Date: 2026-03-30 - Version: v3.24.0 - Original notes: https://github.com/ProtonMail/proton-bridge/releases/tag/v3.24.0 - Permalink: https://whatsnew.fyi/product/proton-mail-bridge/releases/v3.24.0 - Labels: Pre-release; Platforms: Desktop - **added** — Add builder option for Gluon to support IMAP connection limiting - **added** — Add a new package for mapping errors and error chains into a single error - **added** — Add a GODEBUG flag to support RSA keys < 1024 bits - **added** — Add a SplitHeaderBody variant with performance improvements - **changed** — Update go version to 1.26.1 - **changed** — Update golangci-lint to v2.11.3 - **changed** — Optimize message building and decryption process with buffer pooling and improve RFC822 handling - **changed** — Update texts in error messages regarding Hardware Keys authentication flow on Windows - **fixed** — Fix flaky Windows tests and a possible race condition in shared_identity - **fixed** — Revert old pre 3.23.0 RemoveFromMailbox behavior - **fixed** — Fix username not being shown on specific OSes in FIDO authentication flow - **fixed** — Fix messages not being expunged from old locations and separate it from the unlabeling logic ###### Added * BRIDGE-464: Add builder option for Gluon to support IMAP connection limiting. * BRIDGE-480: Added a new package for mapping errors and error chains into a single error. * BRIDGE-426: Added a GODEBUG flag to support RSA keys < 1024 bits. * BRIDGE-479: Added a SplitHeaderBody variant with performance improvements. ###### Changed * BRIDGE-487: Updated go version to 1.26.1 . * BRIDGE-498: Updated golangci-lint to v2.11.3. * BRIDGE-456: Optimize message building and decrpytion process with buffer pooling and improve RFC822 handling. * BRIDGE-482: Updated texts in error messages regarding Hardware Keys authentication flow on Windows. ###### Fixed * BRIDGE-382: Attempt to fix flaky Windows tests & a possible race condition fix in shared_identity. * BRIDGE-488: Revert old pre 3.23.0 RemoveFromMailbox behavior. * BRIDGE-481: Fixed username not being show on specific OSes in FIDO authentication flow. * BRIDGE-485: Fixed messages not being expunged from old locations and separated it from the unlabeling logic. ### v3.23.1 — Bridge Margit v3.23.1 - Date: 2026-03-12 - Version: v3.23.1 - Original notes: https://github.com/ProtonMail/proton-bridge/releases/tag/v3.23.1 - Permalink: https://whatsnew.fyi/product/proton-mail-bridge/releases/v3.23.1 - Labels: Platforms: Desktop - **fixed** — Restore previous RemoveFromMailbox behavior so that drafts moved to trash are not permanently deleted ###### Fixed * BRIDGE-488: Restore previous RemoveFromMailbox behavior (< 3.23.0). Drafts moved to trash should not be perma-deleted. ### v3.23.0 — Bridge Margit v3.23.0 - Date: 2026-03-04 - Version: v3.23.0 - Original notes: https://github.com/ProtonMail/proton-bridge/releases/tag/v3.23.0 - Permalink: https://whatsnew.fyi/product/proton-mail-bridge/releases/v3.23.0 - Labels: Pre-release; Platforms: Desktop - **added** — Add macOS icon customization support - **added** — Add new option to display the current Bridge version in CLI mode - **added** — Display UI spinner when Bridge has no active internet connection to the server - **changed** — Log additional data for Human Verification requests - **changed** — Update macOS tray icon setting descriptions - **changed** — Include the CC header when importing messages - **changed** — Do not call message unlabel endpoints when moving to/from folders - **fixed** — Prevent crashes during synchronization metadata stage (out-of-bounds) - **fixed** — Prevent panic on Windows 10 1809, and resolve runtime crash on Windows 10 22H2 related to Hardware Key authentication - **fixed** — Fix upgrade account banner dismissal when signing in - **fixed** — Resolve Ubuntu autostart issue with multiple escape characters included during overwrite - **fixed** — Display relevant account when selecting from tray menu - **fixed** — Resolve second-password prompt cancellation leading to wrong Login screen ###### Added * BRIDGE-432: MacOS26 new icon customization support. * BRIDGE-312: New option to display the current Bridge version in CLI mode. * BRIDGE-453: Display UI spinner when Bridge has no active internet connection to the server. ###### Changed * BRIDGE-477: Log additional data for Human Verification requests. * BRIDGE-255: Updated macOS tray icon setting descriptions. * BRIDGE-442: Include the CC header when importing messages. * BRIDGE-451: Do not call message unlabel endpoints when moving to/from folders. ###### Fixed * BRIDGE-454: Prevent crashes during synchronization metadata stage (out-of-bounds). * BRIDGE-474: Prevent panic on Windows 10 1809, and resolve runtime crash on Windows 10 22H2 related to Hardware Key authentication. * BRIDGE-444: Upgrade account banner dismisses correctly when signing in. * BRIDGE-431: Resolve Ubuntu autostart issue, multiple escape characters included during overwrite. * BRIDGE-337: Display relevent account when selecting from tray menu. * BRIDGE-452: Resolve second-password prompt cancellation leading to wrong Login screen. ### v3.22.0 — Bridge Laviolette v3.22.0 - Date: 2026-01-28 - Version: v3.22.0 - Original notes: https://github.com/ProtonMail/proton-bridge/releases/tag/v3.22.0 - Permalink: https://whatsnew.fyi/product/proton-mail-bridge/releases/v3.22.0 - Labels: Platforms: Desktop - **added** — Hover tooltip for IMAP/SMTP settings clipboard UI actions - **added** — Support for unavailable keychain retries on Linux to prevent vault wiping, with feature flag support before Bridge initialization - **added** — Rollout feature flag support - **added** — Additional sentry reporting related to auto-update failures - **added** — Debug information on the utilized keychain helper - **added** — Observability caching and metrics for vault related issues - **added** — Generic IMAP OK heartbeat for long lasting commands - **changed** — Modified MBOX header sanitization logic to ensure RFC822 headers are present before stripping content - **changed** — Simplified internal label conflict resolver - **changed** — Increased the import size limit to 55MB - **changed** — Bumped gopenpgp to v2.9.0 - **changed** — Bumped Go to 1.24.11 - **changed** — FIDO2 support - **fixed** — Don't store the last utilized keychain as the user preference on Windows and macOS - **fixed** — Use the address gluon ID instead of the address ID to fetch message counts - **fixed** — Prevent the RFC822 parser from mutating the message literal - **fixed** — Prevent Bridge from crashing when an unknown message charset is detected on import - **fixed** — Adjusted error message for message import size limitation ###### Added * BRIDGE-358: Hover tooltip for IMAP/SMTP settings clipboard UI actions. * BRIDGE-356: Added support for unavailable keychain retries on Linux, such that we don't wipe the vault. Feature flag support before Bridge initialization. * BRIDGE-278: Rollout feature flag support. * BRIDGE-151: Additional sentry reporting related to auto-update failures. * BRIDGE-361: Debug information on the utilized keychain helper. * BRIDGE-396: Observability caching and metrics for vault related issues. * BRIDGE-449: Generic IMAP OK heartbeat for long lasting commands. ###### Changed * BRIDGE-374: Modified MBOX header sanitization logic, it now ensures that RFC822 headers are present before stripping content. * BRIDGE-391: Simplified internal label conflict resolver. * BRIDGE-409: Increased the import size limit to 55MB. * BRIDGE-369: Bumped gopenpgp to v2.9.0. * BRIDGE-455: Bumped Go to 1.24.11. * BRIDGE-424: FIDO2 support. ###### Fixed * BRIDGE-395: Don't store the last utilized keychain as the user preference on Windows & macOS. * BRIDGE-387: Use the address gluon ID, instead of the address ID to fetch message counts. * BRIDGE-394: Prevent the RFC822 parser from mutating the message literal. * BRIDGE-355: Prevent Bridge from crashing when an unknown message charset is detected on Import. * BRIDGE-447: Adjusted error message for message import size limitation. ### v3.21.2 — Bridge Kanmon v3.21.2 - Date: 2025-07-10 - Version: v3.21.2 - Original notes: https://github.com/ProtonMail/proton-bridge/releases/tag/v3.21.2 - Permalink: https://whatsnew.fyi/product/proton-mail-bridge/releases/v3.21.2 - Labels: Platforms: Desktop ###### Fixed * BRIDGE-406: Fixed faulty certificate chain validation logic. Made certificate pin checks exclusive to leaf certificates. ### v3.21.1 — Bridge Kanmon v3.21.1 - Date: 2025-06-12 - Version: v3.21.1 - Original notes: https://github.com/ProtonMail/proton-bridge/releases/tag/v3.21.1 - Permalink: https://whatsnew.fyi/product/proton-mail-bridge/releases/v3.21.1 - Labels: Platforms: Desktop ###### Changed * BRIDGE-383: Extended internal mailbox conflict resolution logic and minor changes to the mailbox conflict pre-checker. ### v3.21.0 — Bridge Kanmon v3.21.0 - Date: 2025-06-09 - Version: v3.21.0 - Original notes: https://github.com/ProtonMail/proton-bridge/releases/tag/v3.21.0 - Permalink: https://whatsnew.fyi/product/proton-mail-bridge/releases/v3.21.0 - Labels: Pre-release; Platforms: Desktop ###### Added * BRIDGE-379: Mailbox pre-check on Bridge startup & conflict resolver for Bridge internal mailboxes. ###### Changed * BRIDGE-376: Explicitly catch Gluon DB mailbox name conflicts and report them to Sentry. * BRIDGE-373: Extend user mailbox conflict resolver logging & report sync errors to Sentry. * BRIDGE-366: Kill switch support for IMAP IDLE. * BRIDGE-363: Observability metric support for IMAP connections. ###### Fixed * BRIDGE-377: Correct API label field usage on user label conflict resolver - update handler (event loop). * BRIDGE-378: Fix incorrect field usage for system mailbox names.