{"id":25436626,"url":"https://github.com/mk1337/protonmail-bridge-docker-arm64","last_synced_at":"2026-05-08T04:36:14.551Z","repository":{"id":277743635,"uuid":"933336857","full_name":"mk1337/protonmail-bridge-docker-arm64","owner":"mk1337","description":"A Dockerized ProtonMail Bridge for ARM64 devices (Rasberry Pi), based on shenxn's unmaintained project.","archived":false,"fork":false,"pushed_at":"2025-02-15T19:24:22.000Z","size":26,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-15T20:25:02.938Z","etag":null,"topics":["arm64","docker","protonmail","protonmail-bridge","raspberry-pi"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mk1337.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-02-15T18:00:53.000Z","updated_at":"2025-02-15T19:24:21.000Z","dependencies_parsed_at":"2025-02-15T20:35:18.374Z","dependency_job_id":null,"html_url":"https://github.com/mk1337/protonmail-bridge-docker-arm64","commit_stats":null,"previous_names":["mk1337/protonmail-bridge-docker-arm64"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mk1337%2Fprotonmail-bridge-docker-arm64","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mk1337%2Fprotonmail-bridge-docker-arm64/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mk1337%2Fprotonmail-bridge-docker-arm64/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mk1337%2Fprotonmail-bridge-docker-arm64/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mk1337","download_url":"https://codeload.github.com/mk1337/protonmail-bridge-docker-arm64/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254264766,"owners_count":22041794,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["arm64","docker","protonmail","protonmail-bridge","raspberry-pi"],"created_at":"2025-02-17T08:21:10.322Z","updated_at":"2026-05-08T04:36:09.525Z","avatar_url":"https://github.com/mk1337.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ProtonMail Bridge for ARM64 (Raspberry Pi)\n\nThis repository provides a **Dockerized version of ProtonMail Bridge** ([Official Repository](https://github.com/ProtonMail/proton-bridge)) specifically modified to work on **ARM64-based Raspberry Pi devices**. It is based on the original [shenxn/protonmail-bridge-docker](https://github.com/shenxn/protonmail-bridge-docker) project, which appears to be unmaintained.\n\n## 🛠️ Initial Development\n\nThis is the first iteration of ARM64 support, completed over half a weekend with ChatGPT's assistance to get it running successfully on my Raspberry Pi. The changes made so far allow it to work on **my machine**, and I hope this will be useful for others as well. The Dockerfile can likely be further optimized and slimmed down. Contributions and pull requests to enhance it further are highly encouraged!\n\n## 🚀 What's Changed\n\nThis fork focuses on **ARM64 support** and ease of deployment on Raspberry Pi devices.\n\n### **🔹 Major Changes in the Dockerfile**\n\n- **Switched to a Debian-based base image and updated the Go build image to the latest supported version** instead of Ubuntu for improved compatibility.\n- **Fixed missing dependencies** that prevented ProtonMail Bridge from running:\n  - Installed essential libraries (`libsecret-1-0`, `libglib-2.0`, `libgobject-2.0`).\n  - Added utilities (`net-tools`, `procps`, `socat`, `iproute2`) for easier debugging.\n- **Updated the build process** to ensure correct compilation on ARM64.\n- **Removed the **``** folder and moved all files to the main directory** to streamline the build since this repo is specifically targeting ARM64. to streamline the build since this repo is specifically targeting ARM64.\n\n### **🔹 Improvements in EntryPoint Script**\n\n- Fixed issues related to process management by ensuring required utilities are installed.\n- Ensured **pass \u0026 GPG key initialization** works properly without requiring a passphrase.\n- Addressed issues where ProtonMail Bridge could not start due to missing dependencies.\n- Improved logging for easier debugging.\n\n## 📌 Supported Platforms\n\nThis version has been tested to work on: ✅ **Raspberry Pi 4 (8GB RAM)** running the latest **Raspberry Pi OS (64-bit)**.\n\n## 🚀 How to Build and Run\n\n### **1️⃣ Build the Docker Image**\n\n```sh\ndocker buildx build --platform linux/arm64 -t protonmail-bridge-arm64 .\n```\n\n### **2️⃣ Run the Container**\n\n```sh\ndocker run --rm -it -v protonmail:/root protonmail-bridge-arm64\n```\n\n## 🔧 Troubleshooting \u0026 Known Issues\n\n### **Bridge Only Listens on 127.0.0.1**\n\nBy default, ProtonMail Bridge **only listens on **``, meaning you cannot bind it to `0.0.0.0` without modifying the source code before building. If you need external access, you will have to patch the Bridge source to allow different binding addresses.\n\n### **Email Sending Issues**\n\n- Ensure that ProtonMail Bridge is running and correctly logged in via the CLI.\n- Verify that SMTP settings are properly configured.\n- If encountering connection issues, confirm that `socat` is correctly forwarding ports.\n\n### **ProtonMail Bridge Not Running Properly**\n\n- Check the logs using:\n  ```sh\n  docker logs protonmail-bridge --tail=50\n  ```\n- Ensure that all required dependencies are installed in the container.\n- If the container exits unexpectedly, try running the Bridge manually inside the container to debug:\n  ```sh\n  docker exec -it protonmail-bridge /protonmail/proton-bridge --cli\n  ```\n\n## 📜 License \u0026 Attribution\n\nThis project is licensed under **GPL-3.0** and is **based on** the original work of [shenxn](https://github.com/shenxn/protonmail-bridge-docker).\n\n---\n\nLet me know if you'd like to add additional sections like **Known Issues** or **Troubleshooting Tips**! 🚀\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmk1337%2Fprotonmail-bridge-docker-arm64","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmk1337%2Fprotonmail-bridge-docker-arm64","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmk1337%2Fprotonmail-bridge-docker-arm64/lists"}