InstallChapters
ManualDownload and install

Install Porch Mail.

One download each for macOS, Windows and Linux. The app, the service that syncs your mail and the command line all come in it.

Download and install

Running in about a minute.

One file each. The app, the service that syncs your mail and the command line all come in it, with nothing else to install.

macOS

Apple siliconmacOS 13 Ventura or later.dmg
Porch Mail
Porch Mail
Applications
  1. 1
    Open the disk image

    Double-click Porch-Mail-arm64.dmg in your Downloads.

  2. 2
    Drag Porch Mail into Applications
  3. 3
    Open it from Applications or Spotlight

    It's signed and notarized by Apple, so it opens without a warning.

Windows

x64Windows 10 or 11.exe
Setup – Porch Mail
Installing Porch MailFor you only · no administrator needed
  1. 1
    Run the installer

    Double-click Porch-Mail-x64-setup.exe. It installs for you only, so it doesn't ask for an administrator.

  2. 2
    If Windows says it protected your PC

    Choose More info, then Run anyway. The installer isn't code-signed yet; its checksum is signed like every release's.

  3. 3
    Open Porch Mail from the Start menu

Linux

x86_64.debpacmanv1.3.0 · 16 Nov 2026 · 74 MB

Debian, Ubuntu and their family

Ubuntu 24.04 or later, Debian 13, Linux Mint 22, Pop!_OS 24.04, elementary OS 8

~/Downloads
$ cd ~/Downloads
$ sudo apt install ./porch-mail_amd64.deb
✓ Setting up porch-mail …
  1. 1
    Download the .deb, then install it with apt

    apt fetches the few libraries it needs. Any distro with glibc 2.39 or newer works.

  2. 2
    Open Porch Mail from your app menu

    Or run porch-mail. Updates arrive in the app; installing one asks for your password.

Arch and its family

Arch Linux, Manjaro, EndeavourOS, CachyOS, Omarchy

~
$ sudo tee -a /etc/pacman.conf <<'EOF'
[porch-mail]
SigLevel = Optional TrustAll
Server = https://github.com/perminder-klair/porch-mail-releases/releases/download/pacman
EOF
$ sudo pacman -Syu porch-mail-bin
✓ installing porch-mail-bin …
  1. 1
    Add our pacman repository, then install

    Paste both commands. It's the same app as the .deb, from the same release, as porch-mail-bin.

  2. 2
    Updates come with the rest of your system

    sudo pacman -Syu keeps it current; the app doesn't update itself here.

A 64-bit PCx86_64, with glibc 2.39 or newer. Not ARM yet.

X11 or XWaylandIt runs on X11; on a Wayland desktop, through XWayland, which most install already.

A keyringGNOME Keyring, KWallet or KeePassXC, for your account passwords. The app says so if there isn’t one.

A Vulkan driverMesa’s, or NVIDIA’s, for drawing the window. Most desktops have it.

Fedora, openSUSE and other distros aren't packaged yet.

Updates come to you. The app checks once a day, checks the release's signature, and asks before it restarts. On Linux, installing one asks for your password; on Windows it doesn't. On Arch, pacman updates it.

Every release is signed. Check a download yourself with its checksums and our public key.

Leaving takes it all. Settings → Remove all data, or porch reset, takes your mail and passwords off the computer before you remove the app. Uninstalling

After installing

It runs in the background
A small service on your computer syncs, files and searches your mail, and shows notifications, even with the window closed. The app starts it for you.
Your passwords
Account passwords and sign-in tokens go to your system keyring: GNOME Keyring or KeePassXC on Linux, the Keychain on macOS, Credential Manager on Windows. On Linux, a keyring must be running for the app to save a password; it says so if there isn’t one.
Updates
The app checks once a day, checks the new release’s signature, and asks before it restarts. Settings → Updates shows the version you have and any update that’s ready. On Linux, installing an update asks for your password; on Windows it installs and reopens the app by itself. On Arch, pacman updates it instead, like the rest of your system.
Checking a download
Every release is signed. Verify a download with its checksums and our public key.

Removing it

On macOS, drag Porch Mail from Applications to the Bin. On Windows, uninstall it in Settings → Apps → Installed apps. On Linux, run sudo apt remove porch-mail, or sudo pacman -R porch-mail-bin on Arch. Your mail stays on your mail server either way: the app only ever kept a copy.