GuideThe 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.

Adding an account

1 · Pick your provider
Gmail, Outlook, Fastmail or Other. Gmail and Outlook open their own sign-in page in your browser: Porch Mail never sees your password. Fastmail takes an API token, which you make in Fastmail’s settings. 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.

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.

Next: the keyboard shortcuts.