[{"data":1,"prerenderedAt":431},["ShallowReactive",2],{"page:\u002Fdownload":3},{"id":4,"title":5,"body":6,"description":421,"extension":422,"meta":423,"navigation":424,"path":425,"robots":426,"seo":427,"sitemap":428,"stem":429,"__hash__":430},"pages\u002Fdownload.md","Download",{"type":7,"value":8,"toc":407},"minimark",[9,14,18,21,26,142,153,157,179,184,191,224,227,230,246,255,259,262,266,269,275,279,291,296,311,315,321,325,338,354,357,363,367,376,379,388,391,395,403],[10,11,13],"h1",{"id":12},"download-penguin-mail","Download Penguin Mail",[15,16,17],"p",{},"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.",[19,20],"release-summary",{},[22,23,25],"h2",{"id":24},"which-package","Which package",[27,28,29,53],"table",{},[30,31,32],"thead",{},[33,34,35,38,41,44,47,50],"tr",{},[36,37],"th",{},[36,39,40],{},".deb",[36,42,43],{},"rpm",[36,45,46],{},"Arch",[36,48,49],{},"Flatpak",[36,51,52],{},"Snap",[54,55,56,77,95,112,127],"tbody",{},[33,57,58,62,65,68,71,74],{},[59,60,61],"td",{},"Updates",[59,63,64],{},"In the app, or apt upgrade",[59,66,67],{},"dnf upgrade",[59,69,70],{},"Download the new .pkg.tar.zst",[59,72,73],{},"flatpak update",[59,75,76],{},"Snap Store",[33,78,79,82,85,87,89,92],{},[59,80,81],{},"GnuPG",[59,83,84],{},"The system's",[59,86,84],{},[59,88,84],{},[59,90,91],{},"The runtime's, on your ~\u002F.gnupg",[59,93,94],{},"The snap's, on your ~\u002F.gnupg",[33,96,97,100,103,105,107,110],{},[59,98,99],{},"Assistant skills",[59,101,102],{},"Yes",[59,104,102],{},[59,106,102],{},[59,108,109],{},"No",[59,111,109],{},[33,113,114,117,119,121,123,125],{},[59,115,116],{},"Claude Code, and MCP servers you run as a command",[59,118,102],{},[59,120,102],{},[59,122,102],{},[59,124,109],{},[59,126,109],{},[33,128,129,132,134,136,138,140],{},[59,130,131],{},"Tray icon",[59,133,102],{},[59,135,102],{},[59,137,102],{},[59,139,102],{},[59,141,102],{},[15,143,144,145,152],{},"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. ",[146,147,151],"a",{"href":148,"rel":149},"https:\u002F\u002Fgithub.com\u002Fc9dev\u002Fpenguin-mail\u002Fblob\u002Fmain\u002Fdocs\u002Fsetup.md#which-package",[150],"nofollow","The setup guide"," has the details.",[22,154,156],{"id":155},"on-macos","On macOS",[15,158,159,160,165,166,170,171,174,175,178],{},"Download the macOS zip for your computer from the ",[146,161,164],{"href":162,"rel":163},"https:\u002F\u002Fgithub.com\u002Fc9dev\u002Fpenguin-mail\u002Freleases\u002Flatest",[150],"latest release",": ",[167,168,169],"code",{},"macos-arm64"," for Apple Silicon or ",[167,172,173],{},"macos-x86_64"," for an Intel Mac. Unzip it and move ",[167,176,177],{},"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.",[180,181,183],"h3",{"id":182},"the-first-time-you-open-it","The first time you open it",[15,185,186,187,190],{},"Apple hasn't notarized the Mac builds yet, so their names end in ",[167,188,189],{},"-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:",[192,193,194,198,214,221],"ol",{},[195,196,197],"li",{},"Open Penguin Mail from Applications, and close the message macOS shows.",[195,199,200,201,205,206,209,210,213],{},"Open ",[202,203,204],"strong",{},"System Settings"," and choose ",[202,207,208],{},"Privacy & Security",". Scroll down to ",[202,211,212],{},"Security",".",[195,215,216,217,220],{},"Next to the line about Penguin Mail, click ",[202,218,219],{},"Open Anyway",". The button stays there for about an hour after you tried to open the app.",[195,222,223],{},"Enter your login password and confirm.",[15,225,226],{},"You do this once per version. After that, Penguin Mail opens like any other app.",[15,228,229],{},"If you would rather use Terminal, this clears the download flag macOS checks, with the same result:",[231,232,237],"pre",{"className":233,"code":234,"language":235,"meta":236,"style":236},"language-sh shiki shiki-themes github-light github-dark","xattr -dr com.apple.quarantine \"\u002FApplications\u002FPenguin Mail.app\"\n","sh","",[167,238,239],{"__ignoreMap":236},[240,241,244],"span",{"class":242,"line":243},"line",1,[240,245,234],{},[15,247,248,249,254],{},"Only do either for a zip you downloaded from Penguin Mail's own ",[146,250,253],{"href":251,"rel":252},"https:\u002F\u002Fgithub.com\u002Fc9dev\u002Fpenguin-mail\u002Freleases",[150],"releases page",". We'll drop these steps once the builds are notarized.",[180,256,258],{"id":257},"updating-and-whats-different","Updating and what's different",[15,260,261],{},"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.",[22,263,265],{"id":264},"install","Install",[267,268],"install-methods",{},[15,270,271,272,213],{},"The apt and dnf repositories are signed with one key, whose fingerprint is ",[167,273,274],{},"FE3C 3B6E 699A F939 DC46 70DC F3A8 5303 5C3E 2B8E",[22,276,278],{"id":277},"from-a-release","From a release",[15,280,281,282,287,288,213],{},"Download ",[283,284],"release-link",{"kind":285,"text":286},"deb","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 ",[167,289,290],{},"sudo apt upgrade",[292,293],"release-command",{"command":294,"label":295},"sudo apt install .\u002Fpenguin-mail_X.Y.Z_amd64.deb","Command to install the .deb",[15,297,298,299,302,303,306,307,310],{},"The same release has a ",[283,300],{"kind":301,"text":301},"tarball"," and a ",[283,304],{"kind":305,"text":305},"zip"," that install under ",[167,308,309],{},"~\u002F.local",", without root:",[292,312],{"command":313,"label":314},"tar xzf penguin-mail-X.Y.Z-x86_64.tar.gz\\ncd penguin-mail-X.Y.Z-x86_64\\n.\u002Finstall-files.sh .","Commands to install the tarball",[15,316,317,318],{},"It starts in the tray at login unless you run it as ",[167,319,320],{},"NO_AUTOSTART=1 .\u002Finstall-files.sh .",[22,322,324],{"id":323},"check-a-download","Check a download",[15,326,327,328,332,333,337],{},"Fetch the release's ",[283,329],{"kind":330,"text":331},"sums","SHA256SUMS"," and ",[283,334],{"kind":335,"text":336},"signature","SHA256SUMS.asc",", and the apt repository's key from the apt commands above, then run:",[231,339,341],{"className":233,"code":340,"language":235,"meta":236,"style":236},"gpgv --keyring .\u002Fpenguin-mail-archive-keyring.gpg SHA256SUMS.asc SHA256SUMS\nsha256sum -c --ignore-missing SHA256SUMS\n",[167,342,343,348],{"__ignoreMap":236},[240,344,345],{"class":242,"line":243},[240,346,347],{},"gpgv --keyring .\u002Fpenguin-mail-archive-keyring.gpg SHA256SUMS.asc SHA256SUMS\n",[240,349,351],{"class":242,"line":350},2,[240,352,353],{},"sha256sum -c --ignore-missing SHA256SUMS\n",[22,355,61],{"id":356},"updates",[15,358,359,360,362],{},"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 ",[202,361,265],{}," 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.",[22,364,366],{"id":365},"try-it-without-an-account","Try it without an account",[231,368,370],{"className":233,"code":369,"language":235,"meta":236,"style":236},"penguin-mail --demo\n",[167,371,372],{"__ignoreMap":236},[240,373,374],{"class":242,"line":243},[240,375,369],{},[15,377,378],{},"On macOS, run this from Terminal instead:",[231,380,382],{"className":233,"code":381,"language":235,"meta":236,"style":236},"\"\u002FApplications\u002FPenguin Mail.app\u002FContents\u002FMacOS\u002Fpenguin-mail\" --demo\n",[167,383,384],{"__ignoreMap":236},[240,385,386],{"class":242,"line":243},[240,387,381],{},[15,389,390],{},"The demo opens three sample accounts in a throwaway store. Nothing talks to Google.",[22,392,394],{"id":393},"from-source","From source",[15,396,397,402],{},[146,398,401],{"href":399,"rel":400},"https:\u002F\u002Fgithub.com\u002Fc9dev\u002Fpenguin-mail\u002Fblob\u002Fmain\u002FCONTRIBUTING.md#building-from-source",[150],"CONTRIBUTING.md"," has the steps, including how to build the Flatpak yourself. Penguin Mail is not on Flathub yet.",[404,405,406],"style",{},"html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":236,"searchDepth":350,"depth":350,"links":408},[409,410,415,416,417,418,419,420],{"id":24,"depth":350,"text":25},{"id":155,"depth":350,"text":156,"children":411},[412,414],{"id":182,"depth":413,"text":183},3,{"id":257,"depth":413,"text":258},{"id":264,"depth":350,"text":265},{"id":277,"depth":350,"text":278},{"id":323,"depth":350,"text":324},{"id":356,"depth":350,"text":61},{"id":365,"depth":350,"text":366},{"id":393,"depth":350,"text":394},"Install Penguin Mail on Linux (Ubuntu, Debian, Fedora, Arch, Flatpak, Snap) and macOS.","md",{},true,"\u002Fdownload",null,{"title":5,"description":421},{"loc":425},"download","xVhXCH5Xu1oeh9qzundwvYdzNrCEg_4C9cp5fxipGWo",1791880223590]