Hydroxide
Hydroxide is a third-party, open-source, CLI-only ProtonMail bridge that translates SMTP, IMAP, and CardDAV traffic into ProtonMail API requests, letting…
Platform availability
Available on 1 of 10 platforms
- Unraid
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server (not listed)
Health score?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). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
23/100 Low
- Maintained
- 0GitHub repository is archived
- Popular
- 672,171 GitHub stars
- Easy to install
- 351 install platform, install notes, Docker image
- Light to run
- No data
- Security check
- 07 serious findings, 2 minor, OpenSSF Scorecard 3.5/10
Based on 4 of 5 factors.
Security check: 7 serious findings
- Uses golang.org/x/crypto v0.48.0, which has a known critical vulnerability (Go)
- Uses golang.org/x/crypto v0.48.0, which has a known critical vulnerability (Go)
- Uses golang.org/x/crypto v0.48.0, which has a known critical vulnerability (Go)
- Uses golang.org/x/crypto v0.48.0, which has a known critical vulnerability (Go)
- Uses golang.org/x/crypto v0.48.0, which has a known critical vulnerability (Go)
- Uses golang.org/x/crypto v0.48.0, which has a known critical vulnerability (Go)
- Uses golang.org/x/crypto v0.48.0, which has a known critical vulnerability (Go)
Automated checks on commit a08bcca, 23 Oct 2026. Not an audit.
Availability: platform listings confirmed today, links checked 35 days ago
- GitHub stars
- 2,171
- Open issues
- 95
- Last commit
- 2026-08-02
- Latest release
- v0.2.32
- License
- MIT
- Activity
- stale
Checked 10 days ago - source: GitHub (emersion/hydroxide)
Resources & Compatibility
ARM (e.g. Raspberry Pi) is supported.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Run auth before starting the bridge First run `hydroxide auth [email protected]` and enter your ProtonMail login and separate mailbox password to get a bridge password. If you skip this, the bridge has no login and your email app cannot connect. source
- Use local ports 1025 and 1143 In your email app, set SMTP (the send server) to 127.0.0.1 port 1025 and IMAP (the receive server) to 127.0.0.1 port 1143 with no security, using your email address and the bridge password. 127.0.0.1 means this computer; if the email app is on another machine, use that machine's address and open those ports so the traffic can reach Hydroxide. source
- Start the bridge with the bridge password Set the `HYDROXIDE_BRIDGE_PASS` environment variable (a secret value the app reads at startup) to the bridge password, then run `hydroxide serve`. Without this, the bridge will not start, so mail on ports 1025 and 1143 and contacts on port 8080 will not work. source
- Repository migration The GitHub repository is archived; the project has migrated to Codeberg. source
- Repository GitHub repository is archived; development migrated to Codeberg. source
- Repository Migration This project has migrated to Codeberg; use the Codeberg repository for current development and issues. source
Fetched 2 days ago - each note links to its source
Variants
Alternatives (1)
- Proton Mail Bridge - App to sync encrypted emails from Proton Mail with desktop email clients such as Mozilla Thunderbird, Apple Mail, and Microsoft Outlook.
Checked 23 days ago - source: AlternativeTo
Common questions
How do I set up authentication and start Hydroxide?
Run hydroxide auth with your ProtonMail address and separate mailbox password to create a bridge password. Set HYDROXIDE_BRIDGE_PASS to that bridge password, then run hydroxide serve. Use your ProtonMail address and the bridge password in the email client.
Which local ports should the email client use for Hydroxide?
Use 127.0.0.1 port 1025 for SMTP and 127.0.0.1 port 1143 for IMAP with no security. If the client is on another machine, use that machine's address and open those ports.
Can Hydroxide log in when two-factor authentication is enabled?
Yes, the project includes a fix for 2FA login with both TOTP and U2F enabled.
Does Hydroxide sync contacts?
Yes, it exposes contacts on port 8080.
Answers sourced from codeberg.org, github.com
Community
Collected 53 days ago - public community threads