# Hydroxide

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. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/1902/hydroxide

## Description

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.

## Health score

23/100 (Low), based on 4 of 5 factors.
- Maintained: 0 (GitHub repository is archived)
- Popular: 67 (2,171 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Security check: 0 (7 serious findings, 2 minor, OpenSSF Scorecard 3.5/10)

## Security check

7 serious findings: Uses golang.org/x/crypto v0.48.0, which has a known critical vulnerability; Uses golang.org/x/crypto v0.48.0, which has a known critical vulnerability; Uses golang.org/x/crypto v0.48.0, which has a known critical vulnerability; Uses golang.org/x/crypto v0.48.0, which has a known critical vulnerability; Uses golang.org/x/crypto v0.48.0, which has a known critical vulnerability; Uses golang.org/x/crypto v0.48.0, which has a known critical vulnerability; Uses golang.org/x/crypto v0.48.0, which has a known critical vulnerability.
Automated checks on commit a08bcca, 23 Oct 2026. Not an audit.

## Links

- Docker Hub: https://hub.docker.com/r/heywoodlh/hydroxide
- Unraid: https://ca.unraid.net/apps/hydroxide-0y99s0g1w5f7r0?q=hydroxide
- GitHub: https://github.com/emersion/hydroxide
- Official website: https://codeberg.org/emersion/hydroxide

## 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.

## Alternatives

- Proton Mail Bridge: App to sync encrypted emails from Proton Mail with desktop email clients such as Mozilla Thunderbird, Apple Mail, and Microsoft Outlook.

---
Source: Our Local Host (https://ourlocalhost.com/app/1902/hydroxide), the self-hosted and open-source app directory.
