ProtonMail Bridge

ProtonMail Bridge is an unofficial Docker container that connects ProtonMail to standard email clients via IMAP and SMTP, letting self-hosted homelab users…

  • Communication
  • Other
  • Tools & Utilities
ProtonMail Bridge is an unofficial Docker container that connects ProtonMail to standard email clients via IMAP and SMTP, letting self-hosted homelab users access their mail from preferred applications.

Platform availability

Available on 3 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox
  • Helm
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

69/100 Good

Maintained
78last commit 43 days ago
Popular
57702 GitHub stars
Easy to install
553 install platforms, install notes, Docker image
Light to run
No data
Security check
79no serious findings, 1 minor, CI

Based on 4 of 5 factors.

Availability: platform listings confirmed today, links checked 7 days ago

GitHub stars
702
Open issues
53
Last commit
2026-10-09
License
GPL-3.0
Activity
stale

Checked 20 days ago - source: GitHub (shenxn/protonmail-bridge-docker)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Keep the Bridge vault and password safe Bridge keeps encrypted settings (its vault) in your home folder under .config/protonmail/bridge-v3 and .cache/protonmail/bridge-v3, and you need a vault password to open them. Back up those folders and remember the password, or you may lose access to your Bridge account setup. source
  • Install the local TLS certificate if asked TLS (the secure connection layer for email) certificates can be installed on your computer or exported to a folder like /tmp/bridge-tls. Do this if your mail app warns about the connection, so your mail client trusts Bridge locally without scary security errors. source
  • Pick login autostart for Bridge Autostart means Bridge starts by itself when you sign in to your computer. Turn it on if you want email synced without manual work; if it is off, you must open Bridge before mail will connect. source
  • Initial CLI setup After first start, enter the container, run entrypoint.sh init, use login to add the account, check info, then restart. source
  • ARM image tags Use the build image tags for ARM devices, such as arm64 and arm/v7. source

Fetched 45 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

How do I add my Proton Mail account after the container starts?

Run the container's init command, wait for the Bridge shell, and use the login command to add the account. Then use info to see the Bridge username and password, and exit when finished.

Which host ports should I expose for the Bridge container?

The example Docker run command exposes 1025 for SMTP and 1143 for IMAP. These map to ports 25 and 143 inside the container.

What data should I back up from Bridge?

Bridge keeps encrypted settings in the home folder under .config/protonmail/bridge-v3 and .cache/protonmail/bridge-v3. Back up those folders and remember the vault password, or you may lose access to your Bridge account setup.

What should I do if a mail client warns about the Bridge connection?

Install the local TLS certificate if you are asked, or export it to a folder such as /tmp/bridge-tls. This lets the mail client trust Bridge locally instead of showing a security warning.

Will Bridge deliver mail to a desktop client at the same time as the Proton mobile app?

One user reports that mail can appear in the Android Proton Mail app first and arrive later in a desktop mail client using Bridge. The thread asks whether Bridge is still a reliable option.

Answers sourced from context7.com, github.com, www.reddit.com

Community

Collected 53 days ago - public community threads