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
249 Commits 1 Branch 0 Tags 629 KiB
Shell 47.3%
Dockerfile 34.9%
Python 17.8%
47526d1b62
Go to file
Trent Maetzold 47526d1b62 Switch base image from debian:sid to debian:trixie (stable)
2026-03-11 12:30:24 -05:00
.github ci: update checkout action to v4 2026-03-11 11:47:59 -05:00
build Switch base image from debian:sid to debian:trixie (stable) 2026-03-11 12:30:24 -05:00
deb chore: update maintainer labels in deb Dockerfile 2026-03-11 11:47:25 -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 docs: update README for fork 2026-03-11 11:47:39 -05:00
SECURITY.md Create SECURITY.md 2020-11-19 23:38:33 -08:00
update-check.py improve build readability and speed (by parallelization) (#117) 2025-04-24 23:03:50 +02:00
VERSION Bump version to v3.22.0 2026-02-10 00:32:52 +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. Some of the scripts are based on Hendrik Meyer's work.

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

Changes from upstream

  • Fixed build for proton-bridge v3.22+ (added libfido2 dependency)
  • Removed DockerHub publishing (GHCR only)
  • Removed Gitee mirror workflow
  • Updated all GitHub Actions to current versions
  • Replaced deprecated Anchore scan with Trivy
  • Default docker-compose binds to localhost only (security)
  • Updated maintainer labels

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 deb image
[version] deb images
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 .