# 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 access their mail from preferred applications. It is open source and self-hosted, installable on Docker Hub, Proxmox, Kubernetes (Helm) and Unraid.

Canonical page: https://ourlocalhost.com/app/768/protonmail-bridge

## Description

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 9 platforms: Unraid, Proxmox, Helm.

## Health score

68/100 (Good), based on 3 of 4 factors.
- Maintained: 81 (last commit 31 days ago)
- Popular: 57 (698 GitHub stars)
- Easy to install: 55 (3 install platforms, install notes, Docker image)

## Links

- Docker Hub: https://hub.docker.com/r/shenxn/protonmail-bridge
- Proxmox: https://community-scripts.github.io/ProxmoxVE/scripts?id=protonmail-bridge
- Kubernetes (Helm): https://artifacthub.io/packages/helm/geek-cookbook/protonmail-bridge
- Unraid: https://ca.unraid.net/apps/protonmail-bridge-0jgbsds1rfdixg?q=protonmail-bridge
- GitHub: https://github.com/shenxn/protonmail-bridge-docker

## 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.

---
Source: Our Local Host (https://ourlocalhost.com/app/768/protonmail-bridge), the self-hosted and open-source app directory.