Getting startedChapters
ManualThe first ten minutes

Getting started.

The first time you open Porch Mail it walks you through adding an account. Here’s what it asks, and why. Not installed yet? See Install.

Adding an account

1 · Pick your provider
Gmail, Outlook, Fastmail, iCloud, Yahoo, Zoho, Proton or Other. Gmail opens Google’s sign-in page in your browser: Porch Mail never sees your password. If Google blocks it while it reviews the app, use an app password. Outlook signs in on Microsoft’s page the same way. Fastmail takes an API token, which you make in Fastmail’s settings. iCloud and Yahoo take an app password, which you make in your account’s security settings. Zoho also asks for your region and plan, and IMAP access must be turned on in Zoho first. Proton works through Proton Mail Bridge, which runs on your computer and needs a paid Proton plan: start Bridge and use the password it shows. Providers says where to make each password. Other is any IMAP server, with your password or an app password.
2 · Test the connection
Each setting says whether it worked, so a wrong server name or password shows up straight away. Sending (SMTP) is optional: without it the account reads mail but doesn’t send.
3 · Watch the first sync
The app reads your recent mail and makes a list of everyone who wrote to you. Nothing is changed on your server.
4 · Sort the senders it found
Put each one in a box: Front, Reader or Ledger, or leave them in the Gate to decide later. People you’ve written to before are let in already.
5 · Read-only, or mirroring
Every account starts read-only: Porch Mail sorts your mail in the app and writes nothing to your server. Turn on mirroring and it files mail into folders on the server, so your phone and webmail see the same boxes. You can choose to file the last 3 months too, and see how many emails that moves first.

Add another account any time: Settings → Accounts, or Add another account in the command palette (Ctrl K).

The boxes

The Gate
Anyone writing for the first time waits here. Let them in to a box, or block them. You decide once per sender; after that their mail goes straight where it belongs.
Front
Mail from people you want to hear from. With mirroring on, it’s what stays in your inbox on every device.
Reader
Newsletters, already open, newest first, to read as one scroll.
Ledger
Receipts, confirmations and notifications: kept, findable, and out of the way.
Reply Queue
Threads you owe a reply. Focus Reply clears them on one page.
Shelf
Threads to keep at hand, from any box.
Blocked and history
Every sender you’ve blocked, with their mail, and every decision you’ve made. Nothing blocked is lost: unblock someone and their mail comes back.
Resurfacing, Muted, Drafts
Threads waiting to come back, threads you’ve muted, and what you’re writing.

Times and dates

Porch Mail follows your computer’s 12- or 24-hour clock. To choose for yourself, go to Settings → Appearance: Clock picks “2:32 PM” or “14:32”, and Dates picks “12 Nov” or “Nov 12”. The app, porch tui and your agents all write dates the same way.

The trial

Every feature works for 7 days, no card needed. After that you can still read, search and sort mail through the Gate, but sending and mirroring pause until you enter a licence key in Settings → Licence. See Your licence.