Hydroxide

Hydroxide is a third-party, open-source, CLI-only ProtonMail bridge that translates SMTP, IMAP, and CardDAV traffic into ProtonMail API requests, letting…

  • Communication
  • Productivity
Hydroxide is a third-party, open-source, CLI-only ProtonMail bridge that translates SMTP, IMAP, and CardDAV traffic into ProtonMail API requests, letting self-hosters use standard email clients with ProtonMail.

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.

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

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