Setting up Proton

Proton publishes no API that other applications may use for a person's mailbox or drive yet. The supported route to Proton Mail is Proton Mail Bridge, an app that runs on your computer and serves your mailbox over IMAP and SMTP on 127.0.0.1. The Proton Drive SDK is an early preview, is not published to NuGet, and Proton says it is not ready for third-party production use. The route to Proton Drive is therefore the Proton Drive app, which keeps a folder on your Mac in sync.

Both halves of this package run on the Mac where those apps run, under the mesh you run there (LocalMesh). Everything below happens once, on that Mac.

🚨 A cloud portal cannot do this. It has no Bridge to reach and no Proton Drive folder to read. There, the Proton Mail connection and the Proton Drive tile say that they run on your computer, and nothing tries to connect.

1. Turn the module on in LocalMesh

The package ships as an assembly. List it where the host loads modules:

{ "Modules": { "Assemblies": [ "MeshWeaver.Proton" ] } }

On a Mac nothing else is needed. Optional settings, all under Proton:

{
  "Proton": {
    "LocalHost": true,
    "Drive": { "Root": "" }
  }
}
Setting Default When to set it
Proton:LocalHost true on macOS, false elsewhere true for a mesh you run on your own Linux or Windows desktop next to Bridge; false to switch the module off on a Mac
Proton:Drive:Root empty (find the folder) to name your Proton Drive folder exactly, instead of finding it under ~/Library/CloudStorage

Restart the host after changing either.

2. Proton Mail

Install and sign in to Bridge

  1. Bridge needs a paid Proton plan that includes Proton Mail. Proton says so on its Bridge page.
  2. Download Proton Mail Bridge from proton.me, install it and sign in with your Proton account.
  3. Leave Bridge running. It starts with your Mac unless you turn that off.

Copy the Bridge sign-in

In Bridge, open your account and choose Mailbox details (the IMAP/SMTP settings). Copy two values:

Bridge's defaults are host 127.0.0.1, IMAP port 1143, SMTP port 1025, connection mode STARTTLS. If Bridge's settings show other ports (Bridge changes them when another app uses the defaults) or the connection mode SSL, note those too.

Connect

In the portal, open Settings › Connections › Proton Mail and enter the user name and the Bridge password. Fill in the ports and the connection mode only if they differ from the defaults. Then press Test connection. It signs in to Bridge over IMAP, then over SMTP, and reads nothing.

You see It means
Connected Bridge accepted the sign-in
Rejected Bridge refused the user name or password. Copy both again from Mailbox details
Couldn't tell Nothing answered on that port. Bridge is not running, or the port or connection mode differs from Bridge's settings
Not connected with "runs on your computer" You are on a cloud portal, not on your Mac's mesh

The address field accepts only 127.0.0.1 or ::1. Bridge listens on this computer alone, and the module never contacts any other machine for Proton Mail. Bridge serves its own self-signed certificate. The module accepts that certificate for those two loopback addresses and nowhere else.

The Bridge password is stored encrypted in your own _Connections, or not stored at all when this mesh has no encryption key. It is never written to a log.

Your Proton inbox in the unified inbox

Once connected, your Proton Mail INBOX appears in your inbox (/{you}/Inbox) under Mail, newest first. Each row shows the sender, the subject, the time in your time zone, whether it is read, and a short preview. Opening a row reads the message from Bridge at that moment.

The assistant: it drafts, you send

The Proton Mail agent (Proton/Agent/ProtonMail) lists and reads your inbox and writes mail and replies into your Proton Drafts. You review them in Proton Mail and press Send.

3. Proton Drive

  1. Install the Proton Drive app for macOS from proton.me and sign in.
  2. The app keeps your drive in a folder under ~/Library/CloudStorage, named after your account (ProtonDrive-…). In Finder it appears under Locations › Proton Drive.
  3. In a space's menu choose Synchronizations, then Proton Drive, and pick the folder to sync with that space.

The space syncs with that folder, and the Proton Drive app carries the changes to Proton.

When Proton publishes its Drive SDK, a provider using it can replace the folder route. A space's sync settings would not change.

What this is not

It is not a Proton product, and Proton does not support it. It talks to Bridge over standard IMAP and SMTP, and to the Proton Drive app's folder as ordinary files. A Bridge or Proton Drive update can change what they expose. When that happens, the connection test and the inbox report the failure; they do not fail silently.