Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/sdelafond/docker-protonmail-bridge

Run ProtonMail Bridge in a docker container
https://github.com/sdelafond/docker-protonmail-bridge

docker docker-compose imap imap-server protonmail protonmail-bridge smtp smtp-server

Last synced: 3 days ago
JSON representation

Run ProtonMail Bridge in a docker container

Awesome Lists containing this project

README

        

Run ProtonMail Bridge in a docker container

Usage
=====

Starting the service
--------------------

1. get the Debian package for the bridge from ProtonMail, and save it in
the current directory

2. create your env file from the default one
```
cp default-env .env
```

3. edit .env to add your ProtonMail credentials; you can leave out
PROTONMAIL_EXTRA_2FA blank: since that value depends on time, you'll
instead want to specify it when running the service

4. start the service
```
PROTONMAIL_EXTRA_2FA= docker-compose up
```

Configuring your email client
-----------------------------

For credentials, use the "Username: " and "Password: "
that the service prints when it start.

The URL for the IMAP service is `localhost:2143`, and the SMTP one is
`localhost:2025`.

Client compatibility
--------------------

The ProtonMail Bridge officially supports Thunderbird only, but using
offlineimap or fetchmail works just fine. Here's an example
.fetchmailrc:

```
set daemon 15

defaults
fetchall
# keep

poll 127.0.0.1 service 2143 with protocol imap auth password
user there is seb here
password
```

SSL certificates
================

SMTP
----

Full certificate information:
```
echo | openssl s_client -connect localhost:2025 -starttls smtp | openssl x509 -noout -text
```

Fingerprints:
```
echo | openssl s_client -connect localhost:2025 -starttls smtp | openssl x509 -noout -fingerprint -md5
echo | openssl s_client -connect localhost:2025 -starttls smtp | openssl x509 -noout -fingerprint -sha1
echo | openssl s_client -connect localhost:2025 -starttls smtp | openssl x509 -noout -fingerprint -sha256
[...]
```

IMAP
----

Full certificate information:
```
echo | openssl s_client -connect localhost:2143 -starttls imap | openssl x509 -noout -text
```

Fingerprints:
```
echo | openssl s_client -connect localhost:2143 -starttls imap | openssl x509 -noout -fingerprint -md5
echo | openssl s_client -connect localhost:2143 -starttls imap | openssl x509 -noout -fingerprint -sha1
echo | openssl s_client -connect localhost:2143 -starttls imap | openssl x509 -noout -fingerprint -sha256
[...]
```

Credits
=======

Thanks to Hendrik Meyer for socat+setcap workaround described at
https://gitlab.com/T4cC0re/protonmail-bridge-docker