Skip to content

Download Penguin Mail

Penguin Mail runs on Linux x86_64 and macOS (Apple Silicon and Intel). On Linux, the .deb, the rpm, the Arch package and the Flatpak need GTK 4.20, libadwaita 1.8 and WebKitGTK 6.0 from your distribution, as Ubuntu 26.04, Fedora 43 and Arch's own repositories have; the snap brings its own. On Ubuntu 24.04 and releases built on it, such as Pop!_OS 24.04 and Linux Mint 22, apt refuses the .deb for its older GTK and libadwaita; install the snap there. The tray icon needs a StatusNotifier host, which Ubuntu's AppIndicator extension provides.

Which package

.debrpmArchFlatpakSnap
UpdatesIn the app, or apt upgradednf upgradeDownload the new .pkg.tar.zstflatpak updateSnap Store
GnuPGThe system'sThe system'sThe system'sThe runtime's, on your ~/.gnupgThe snap's, on your ~/.gnupg
Assistant skillsYesYesYesNoNo
Claude Code, and MCP servers you run as a commandYesYesYesNoNo
Tray iconYesYesYesYesYes

Skills are off in the Flatpak and snap because a skill's scripts run in a sandbox of their own, which cannot start inside either package's sandbox. That sandbox also keeps the app from starting programs installed on your system, such as Claude Code. The setup guide has the details.

On macOS

Download the macOS zip for your computer from the latest release: macos-arm64 for Apple Silicon or macos-x86_64 for an Intel Mac. Unzip it and move Penguin Mail.app to Applications. The bundle includes its GTK libraries, so you do not need Homebrew to run it. The app bundle records the minimum macOS version each build requires.

The first time you open it

Apple hasn't notarized the Mac builds yet, so their names end in -unsigned. They are signed, but not with an Apple developer certificate, and macOS blocks the first launch with a message that it could not verify the app. To open it anyway:

  1. Open Penguin Mail from Applications, and close the message macOS shows.
  2. Open System Settings and choose Privacy & Security. Scroll down to Security.
  3. Next to the line about Penguin Mail, click Open Anyway. The button stays there for about an hour after you tried to open the app.
  4. Enter your login password and confirm.

You do this once per version. After that, Penguin Mail opens like any other app.

If you would rather use Terminal, this clears the download flag macOS checks, with the same result:

xattr -dr com.apple.quarantine "/Applications/Penguin Mail.app"

Only do either for a zip you downloaded from Penguin Mail's own releases page. We'll drop these steps once the builds are notarized.

Updating and what's different

To update, download the next macOS zip and replace the app in Applications, then allow it again as above. Your mail and settings stay in your user folder. The macOS app has no tray icon. GnuPG and command-line assistants are not bundled.

Install

Ubuntu and Debian · apt

sudo curl -fsSLo /usr/share/keyrings/penguin-mail-archive-keyring.gpg \
  https://c9dev.github.io/penguin-mail/penguin-mail-archive-keyring.gpg
sudo curl -fsSLo /etc/apt/sources.list.d/penguin-mail.sources \
  https://c9dev.github.io/penguin-mail/penguin-mail.sources
sudo apt update && sudo apt install penguin-mail

sudo apt upgrade brings each new version with the rest of the system.

Fedora · dnf

sudo curl -fsSLo /etc/yum.repos.d/penguin-mail.repo \
  https://c9dev.github.io/penguin-mail/rpm/penguin-mail.repo
sudo dnf install penguin-mail

dnf asks you to accept the key the first time. sudo dnf upgrade brings each new version.

Any distribution with Flatpak · Flatpak

flatpak install --user https://c9dev.github.io/penguin-mail/flatpak/penguin-mail.flatpakref

flatpak update brings each new version. The GNOME runtime comes from Flathub.

Arch · AUR

penguin-mail-bin installs the release binary. To build the release from source instead, install penguin-mail.

yay -S penguin-mail-bin

Your AUR helper brings each new version with the rest of the system.

Any distribution with snapd · Snap

The snap is waiting for the Snap Store to approve its access to ~/.gnupg and the keyring. The command finds it once the store has.

sudo snap install penguin-mail --edge

The Snap Store brings new versions, to the edge channel first.

The apt and dnf repositories are signed with one key, whose fingerprint is FE3C 3B6E 699A F939 DC46 70DC F3A8 5303 5C3E 2B8E.

From a release

Download the .deb from the latest release and install it. apt pulls in the libraries it needs, and the .deb adds the apt repository, so later versions arrive with sudo apt upgrade.

sudo apt install ./penguin-mail_X.Y.Z_amd64.deb

The same release has a tarball and a zip that install under ~/.local, without root:

tar xzf penguin-mail-X.Y.Z-x86_64.tar.gz
cd penguin-mail-X.Y.Z-x86_64
./install-files.sh .

It starts in the tray at login unless you run it as NO_AUTOSTART=1 ./install-files.sh .

Check a download

Fetch the release's SHA256SUMS and SHA256SUMS.asc, and the apt repository's key from the apt commands above, then run:

gpgv --keyring ./penguin-mail-archive-keyring.gpg SHA256SUMS.asc SHA256SUMS
sha256sum -c --ignore-missing SHA256SUMS

Updates

A copy installed on Linux from the .deb, the tarball or source checks GitHub for a new release once a day. When one is out, it tells you, and Install does the rest. Before it installs anything, it checks the release's signature against the key built into the app, then checks the download against the signed sums. The rpm leaves updates to dnf, and the snap to the Snap Store. The macOS app has no in-app installer: download the next macOS zip from the releases page and replace Penguin Mail.app in Applications.

Try it without an account

penguin-mail --demo

On macOS, run this from Terminal instead:

"/Applications/Penguin Mail.app/Contents/MacOS/penguin-mail" --demo

The demo opens three sample accounts in a throwaway store. Nothing talks to Google.

From source

CONTRIBUTING.md has the steps, including how to build the Flatpak yourself. Penguin Mail is not on Flathub yet.