Mouws/protonmail-bridge-nextcoud-podman
1
0
Fork 1
mirror of https://github.com/shenxn/protonmail-bridge-docker.git synced 2026-03-26 21:35:58 +00:00
Code Issues Actions 1 Packages Projects Releases Wiki Activity
ProtonMail IMAP/SMTP Bridge Docker container
266 Commits 1 Branch 0 Tags 629 KiB
Shell 47.3%
Dockerfile 34.9%
Python 17.8%
39947ed674
Go to file
Trent Maetzold 39947ed674
Merge pull request #1 from trent-maetzold/fix/build-and-cleanup 
Fix build for v3.22+, update to GHCR, cleanup workflows
2026-03-11 16:05:15 -05:00
.github/workflows Use latest Trivy action 2026-03-11 20:15:25 +00:00
build Switch base image from debian:sid to debian:trixie (stable) 2026-03-11 12:30:24 -05:00
.gitignore Add riscv64 support to docker builds 2022-11-20 23:32:58 +08:00
docker-compose.yml security: bind to localhost, use GHCR image 2026-03-11 11:47:32 -05:00
LICENSE Update LICENSE 2020-04-23 17:23:13 -07:00
README.md Remove shenxn funding, update SECURITY.md, deb Dockerfile to trixie, add acknowledgments to README 2026-03-11 18:02:44 +00:00
SECURITY.md Remove shenxn funding, update SECURITY.md, deb Dockerfile to trixie, add acknowledgments to README 2026-03-11 18:02:44 +00:00

README.md

ProtonMail IMAP/SMTP Bridge Docker Container

Fork of shenxn/protonmail-bridge-docker with build fixes, updated dependencies, and GHCR publishing.

build badge

This is an unofficial Docker container of the ProtonMail Bridge.

GHCR: ghcr.io/trent-maetzold/protonmail-bridge

Changes from upstream

  • Fixed build for proton-bridge v3.22+ (added libfido2 dependency)
  • Switched base image from debian:sid to debian:trixie (stable)
  • Removed DockerHub publishing (GHCR only)
  • Removed Gitee mirror workflow
  • Merged version check into build workflow with scheduled auto-update
  • Updated all GitHub Actions to current versions
  • Replaced deprecated Anchore scan with Trivy
  • Default docker-compose binds to localhost only (security)
  • Updated maintainer labels and security policy

ARM Support

ARM devices (arm64 and arm/v7) are supported. Use the images tagged with build.

Tags

There are two types of images:

  • deb: Images based on the official .deb release. amd64 only.
  • build: Images compiled from source code. Supports amd64, arm64, arm/v7, and riscv64.
tag description
latest latest build image
build latest build image
[version]-build build images

Initialization

To initialize and add an account to the bridge:

docker run --rm -it -v protonmail:/root ghcr.io/trent-maetzold/protonmail-bridge:build init

Or with Docker Compose:

docker compose run protonmail-bridge init

Wait for the bridge to start, use login to add your account, info to see credentials, then exit. You may need CTRL+C to fully exit.

Run

docker run -d --name=protonmail-bridge -v protonmail:/root \
  -p 127.0.0.1:1025:25/tcp -p 127.0.0.1:1143:143/tcp \
  --restart=unless-stopped ghcr.io/trent-maetzold/protonmail-bridge:build

Or with Docker Compose:

docker compose up -d

Security

The default configuration binds ports to localhost only. If you need network access, update the port bindings — but use a firewall on untrusted networks.

Bridge CLI Guide

The initialization step exposes the bridge CLI for configuration (combined/split mode, proxy, etc.). See the official guide.

Build

To build locally:

cd build
docker build --build-arg version=v3.22.0 .

Acknowledgments

This project is a fork of shenxn/protonmail-bridge-docker by Xiaonan Shen, which provided the original Dockerfiles, entrypoint scripts, and CI pipeline. Some scripts are based on Hendrik Meyer's work.

License

GPLv3