TroubleshootingChapters
ManualWhen something’s wrong

Troubleshooting.

When an account can’t sign in or reach its server, the app checks each step and says how to fix the one that failed.

Check an account

Check connection
Settings → Accounts → Check connection looks up the server, makes the secure connection, signs in, and lists what the server supports. It checks the outgoing server too, without sending anything. Each problem comes with a fix.
From a terminal
porch doctor runs the same checks for every account. porch doctor activity shows what syncing is doing and the recent errors.

Common problems

The password was rejected
Settings → Accounts → Reconnect, and enter it again. Gmail and Outlook open your browser to sign in again.
New mail is slow to arrive
Some servers can’t tell the app about new mail straight away. The app then checks every minute. Check connection says whether yours can.
It can’t save a password (Linux)
Passwords go to your system keyring. Install and unlock GNOME Keyring or KeePassXC, then try again.
Windows says it protected your PC
The installer isn’t code-signed yet, so SmartScreen warns the first time. Choose More info, then Run anyway. Its checksum is signed like every release’s.
No notifications
They’re off until you turn them on for a sender or a thread. Settings → Notifications sends a test, and shows your quiet hours.
I can’t send
A read-only account doesn’t send: turn on mirroring for it in Settings → Accounts. After the trial, sending needs a licence key.
A thread disappeared
Search with in:done, in:trash or in:muted, and look under Resurfacing in the sidebar.
A sender’s mail never shows
They may be waiting at the Gate, or blocked. Look in the Gate, and in Blocked and history.

Reporting a bug

Run porch doctor report and send what it prints to hi@porch.email. It leaves out passwords, tokens, your mail and the first part of every address.