Uninstalling Porch Mail.
Removing the app leaves your mail and passwords behind. Remove them first, then the app.
1 · Remove all data
- Passwords and keys
- Your accounts’ passwords and sign-in tokens, AI provider keys and your licence key, from the system keyring (the login Keychain on a Mac, Credential Manager on Windows).
- Your mail on this computer
- The mail database: the copies of your messages, your Gate decisions, boards, settings and snippets.
- Everything else it wrote
- Cached images and downloaded updates, the email viewer’s cache, the daemon’s log, the window layout, copies of attachments you opened, the porch command, and the daemon starting at login.
- Porch’s filing script
- If an account was mirroring with server-side filing, the Sieve script that filed new mail at delivery comes off the server, so new mail stops going into Gate.
In the app: Settings → Remove all data. It lists what goes and what stays, asks once more, removes it all and quits. Opening the app again afterwards is a first run, like a new install. Or, with the app closed, in a terminal:
$ porch reset --dry-run
$ porch reset
--dry-run only lists it. Without it, porch reset shows the same list and asks you to type remove. Fixing a broken setup rather than leaving? --keep-licence keeps your licence key (the app has the same checkbox).
2 · Remove the app
On Linux:
$ sudo apt remove porch-mail
Or, on Arch and its derivatives:
$ sudo pacman -R porch-mail-bin
On a Mac, drag Porch Mail from Applications to the Bin.
On Windows, uninstall it in Settings → Apps → Installed apps. That also stops the background service starting when you sign in.
Neither apt nor pacman can do step 1 for you: it runs as root, without your keyring, and other people on the computer have their own Porch Mail data.
What stays
- The trial’s start date
- One date stays in your keyring so the trial can’t restart. It’s nothing personal: no address, no mail.
- Your mail on your servers
- Nothing on a mail server is deleted. Folders Porch Mail made there (Gate, Reader, Ledger) and the journal folder your devices sync through stay; delete them in another mail client if you want them gone.
- Agent setups
- If you added Porch Mail to Claude Code or Claude Desktop, remove porch-mail there (claude mcp remove porch-mail).
Already removed the app?
On Windows the command line goes with the app, so run porch reset before you uninstall it. On Linux, the command line comes as one file of its own too: porch-linux-x64. Download it and run it with reset:
$ chmod +x ~/Downloads/porch-linux-x64
$ ~/Downloads/porch-linux-x64 reset
By hand
- Folders
- porch-mail (and untitled-mail, its name before) in ~/.local/share, ~/.config, ~/.cache, ~/.local/state, and in $XDG_RUNTIME_DIR on Linux or $TMPDIR on a Mac. On Linux also mail-desktop in ~/.cache and ~/.local/share: the email viewer’s cache. On Windows, porch-mail in %LOCALAPPDATA% and %APPDATA%.
- The porch command
- ~/.local/bin/porch (on Windows, porch.cmd in %LOCALAPPDATA%\Microsoft\WindowsApps), or wherever Settings → Command line put it.
- Keyring items
- Those whose service (schema) is dev.porch.mail.Account, dev.porch.mail.AiKey, or dev.porch.mail.Licence with the account “key”. Leave “trial-start”. On Windows they’re in Credential Manager, under Windows Credentials, named dev.porch.mail.…/….
- systemd (Linux)
- If you turned on starting at login: systemctl --user disable porch-mail.
On a Mac, this removes the Keychain items (run each line until it says the item could not be found):
$ security delete-generic-password -s dev.porch.mail.Account
$ security delete-generic-password -s dev.porch.mail.AiKey
$ security delete-generic-password -s dev.porch.mail.Licence -a key
Everything Porch Mail stores, and where, is on Trust.