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
| .deb | rpm | Arch | Flatpak | Snap | |
|---|---|---|---|---|---|
| Updates | In the app, or apt upgrade | dnf upgrade | Download the new .pkg.tar.zst | flatpak update | Snap Store |
| GnuPG | The system's | The system's | The system's | The runtime's, on your ~/.gnupg | The snap's, on your ~/.gnupg |
| Assistant skills | Yes | Yes | Yes | No | No |
| Claude Code, and MCP servers you run as a command | Yes | Yes | Yes | No | No |
| Tray icon | Yes | Yes | Yes | Yes | Yes |
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:
- Open Penguin Mail from Applications, and close the message macOS shows.
- Open System Settings and choose Privacy & Security. Scroll down to Security.
- 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.
- 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.gpgsudo curl -fsSLo /etc/apt/sources.list.d/penguin-mail.sources \
https://c9dev.github.io/penguin-mail/penguin-mail.sourcessudo apt update && sudo apt install penguin-mailsudo 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.reposudo dnf install penguin-maildnf 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.flatpakrefflatpak 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-binYour 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 --edgeThe 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.debThe same release has a tarball and a zip that install under ~/.local, without root:
tar xzf penguin-mail-X.Y.Z-x86_64.tar.gzcd 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 SHA256SUMSsha256sum -c --ignore-missing SHA256SUMSUpdates
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 --demoOn macOS, run this from Terminal instead:
"/Applications/Penguin Mail.app/Contents/MacOS/penguin-mail" --demoThe 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.