← Directory

protonmail-bridge

ProtonMail Bridge for e-mail clients.

  • Other
  • Tools & Utilities
ProtonMail Bridge for e-mail clients. After the container has started you will need to access the CLI to do the initial setup. From Unraid terminal and run the following: ```bash docker exec -it protonmail-bridge /bin/bash chmod +x entrypoint.sh ./entrypoint.sh init ``` Wait for the bridge to startup, use `login` command and follow the instructions to add your account into the bridge. Then use `info` to see the configuration information (username and password). After that, use `exit` to exit the bridge. You may need CTRL+C to exit the docker entirely. Then restart the container.

Platform availability

Available on 3 of 6 install platforms

Also on Docker Hub and GitHub

Health score

68/100 Good

Maintained
82last commit 14 days ago
Popular
57698 GitHub stars
Easy to install
553 install platforms, install notes, Docker image
Light to run
No data

Based on 3 of 4 factors.

How is this calculated?

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). Factors without data are left out and the rest are rescaled.

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

GitHub stars
698
Open issues
53
Last commit
2026-09-22
License
GPL-3.0
Activity
rising

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

Resources & Compatibility

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

Checked 7 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

Fetched 7 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 6 days ago - public community threads