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 doctorruns the same checks for every account.porch doctor activityshows 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:trashorin: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.