Accounts and devicesChapters
ManualAccounts, mirroring, devices

Accounts and devices.

Keep your provider. Porch Mail works on the mailbox you have, and your phone and webmail can see the same boxes.

Several accounts

Add one
Settings → Accounts, or Add another account in the command palette (Ctrl K). It runs the same steps as the first time.
Together
Every account’s mail shares the same boxes, one search and one All Files. The sidebar can show one account at a time.
Remove one
Settings → Accounts. The mail stays on your server.

Providers

Gmail
Sign in with Google in your browser, so Porch Mail never sees your password. While Google reviews the app, use an app password instead: see Gmail and Outlook below.
Outlook
Sign in with Microsoft in your browser, for Outlook.com, Hotmail and Microsoft 365. A work or school account may need an administrator to approve Porch Mail first: see Gmail and Outlook below.
iCloud
Make an app-specific password at appleid.apple.com → Sign-In and Security (two-factor authentication must be on), and use it with your iCloud address. The servers are filled in for you.
Yahoo
Make an app password in Yahoo’s Account security settings, and use it with your Yahoo address. The servers are filled in for you.
Fastmail
Make an API token in Fastmail’s Settings → Privacy & Security → API tokens. Fastmail files your mail itself, even with your computer off.
Zoho Mail
Turn on IMAP access in Zoho Mail first (Settings → Mail Accounts → IMAP Access), then pick your region and plan. With two-factor authentication on, use an app-specific password (Account → Security → App Passwords).
Proton Mail
Proton Mail has no IMAP of its own: install Proton Mail Bridge (on Proton’s paid plans) on the same computer, and use the password Bridge shows you, not your Proton password. Bridge must be running for mail to arrive and send.
Any IMAP or JMAP
Your own server, your company’s, or a provider not listed here. Pick Other and enter the IMAP and SMTP servers, with your password or an app password.

Passwords and tokens stay in your system’s keychain, never in the app’s files. If an account won’t connect, see Troubleshooting.

Gmail and Outlook

Gmail
Pick Gmail, then Continue in browser. Google’s own sign-in page opens, you approve Porch Mail there, and the app connects. It never sees your password.
“Didn’t give Porch Mail access to your mail”
Google’s page lists the permissions as boxes, and the one for your mail can start unticked. Sign in again and tick “Read, compose, send and permanently delete all your email from Gmail” before you continue: Porch Mail needs it to read and send your mail at all.
“Access blocked” or “unverified app”
Google is still reviewing Porch Mail, and until it finishes only a short list of testers can sign in this way. Everyone else connects with an app password instead, in three steps below. Nothing about your mail changes later: you can switch to browser sign-in once the review is done.
App password, step 1
Turn on 2-Step Verification for your Google account, at myaccount.google.com. Google only offers app passwords to accounts that have it.
App password, step 2
Make an app password at myaccount.google.com/apppasswords. Call it Porch Mail. Google shows it once: 16 letters.
App password, step 3
In Porch Mail pick Gmail, then Use an app password instead. Gmail’s servers are filled in for you. Enter your full Gmail address as the username, paste the app password, and test the connection.
Work or school Gmail
If Google says app passwords aren’t available, your administrator has turned them off. Ask them to allow Porch Mail, or to turn app passwords on.
When it stops working
Changing your Google password cancels every app password. Make a new one, then Settings → Accounts → Reconnect. An account that signed in through the browser just signs in again.
Outlook
Pick Outlook, then Continue in browser, and sign in on Microsoft’s own page. It works for Outlook.com, Hotmail and Live addresses. Microsoft shows Porch Mail as unverified until its review is done; that’s expected.
Work or school Outlook
Microsoft 365 accounts from an organisation may need an administrator to approve Porch Mail first, while it’s unverified. If yours does, Microsoft says so on its sign-in page.
A Microsoft account with a Gmail address
If your Microsoft account signs in with another address, such as a Gmail one, Porch Mail asks for its Outlook address after you sign in: the one your Outlook mail goes to. Your mail is sent from that address.
“Has no Outlook mailbox”
The account has no Outlook mail behind it. Add an Outlook address to it at outlook.com, or sign in with the account that has your Outlook.com, Hotmail or Microsoft 365 address.

Have your own Google or Microsoft app registration? Put its client ids in ~/.config/porch-mail/oauth.json, then log out and back in so the app’s background service reads it. Browser sign-in then uses your registration instead of ours. A Google client is a “Desktop app” client; a Microsoft one is a public client allowed to redirect to http://127.0.0.1, for personal and work accounts.

{
  "google": { "clientId": "…", "clientSecret": "…" },
  "microsoft": { "clientId": "…" }
}

Read-only or mirroring

Read-only
Every account starts here. The app sorts your mail on your computer and writes nothing to your server: no folders, no flags, no sending.
Mirroring
The app files mail into folders on your server as you decide, so your phone and webmail show the same boxes, and what you read is read everywhere. Sending needs it too.
Turning it on
Settings → Accounts, per account. You can also file your last 3 months, and see how many emails that moves before it does.
How fast
Servers that can file mail themselves, like Fastmail, sort new mail as it arrives, even with your computer off. On Gmail and Outlook the app files it within seconds while it runs.

Your decisions on every computer

What syncs
Gate decisions, the Reply Queue and Shelf, Resurface, Done and Delete, Mute, renamed subjects, merges, stacks, notification choices, snippets and boards.
How
Through a hidden folder in your own mailbox. There’s no server of ours in between.
Turn it on
Settings → Accounts, per account. It’s off by default, because the folder isn’t encrypted: anyone who can read your mailbox can read your decisions and snippets.
What stays on each computer
Settings, AI suggestions and the notification history. Drafts travel through your server’s Drafts folder instead.

More on what is stored where: Trust.