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
- Bridge needs a paid Proton plan that includes Proton Mail. Proton says so on its Bridge page.
- Download Proton Mail Bridge from proton.me, install it and sign in with your Proton account.
- 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:
- the user name, which is your Proton address;
- the Bridge password, a long password Bridge generated. This is not your Proton account password, and your Proton account password will not work here.
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.
- Nothing is copied into the mesh. Every list and every opened message is read live from Bridge.
- Only you see it. Other users of the same mesh, and the system itself, get nothing, and Bridge is not contacted for them.
- Read-only. This version does not delete, move or mark messages, and opening one does not mark it read.
- When Bridge cannot be read, the source says so and tells you what to check. It never shows an empty list that looks like "no new mail".
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.
- A wrong draft is amended, not drafted twice. Bridge cannot edit a message in place, so the amended version replaces the draft. Before it writes, the assistant checks again that the draft is still in Drafts. If you sent or discarded it meanwhile, nothing is changed.
- Sending is possible only when the deployment sets
Email:AgentSendtoSend, the same switch as for the Executive Assistant. Under the default,DraftOnly, the agent has no send tool at all.
3. Proton Drive
- Install the Proton Drive app for macOS from proton.me and sign in.
- The app keeps your drive in a folder under
~/Library/CloudStorage, named after your account (ProtonDrive-…). In Finder it appears under Locations › Proton Drive. - 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.
- Only folders inside your Proton Drive folder are offered, and a sync source pointing anywhere else is refused. The tile is not a general file browser for your Mac.
- Signing out leaves a folder behind. Each time you sign out of the Proton Drive app it renames the
old folder to
ProtonDrive-<account> (<date and time>). Those folders no longer sync and are never offered. After you sign in again, choose the folder again if the sync reports that it is gone. - If no folder is found, the tile says so. Install and sign in to the Proton Drive app, or set
Proton:Drive:Root.
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.