Install
Install ShellYard on macOS, Windows, or Linux. Verify the download with SHA256SUMS and GPG. Workarounds for Gatekeeper and SmartScreen while builds are unsigned.
Caveat
macOS Developer ID notarization + Windows MSI Authenticode signing are wired into the publish scripts but env-var gated. DUNS approval is in flight; certs land 2026-05-08, after which builds ship signed by default. Until then, the workarounds below get you running.
ShellYard ships from releases.shellyard.com (CDN-fronted from S3) as platform-specific artifacts. The download page on this site reads releases.shellyard.com/latest.json once on page load and surfaces every build for the current release.
| Platform | Artifact | Best for |
|---|---|---|
| macOS Apple Silicon | shellyard-darwin-arm64.zip | M-series Macs |
| macOS Intel | shellyard-darwin-amd64.zip | Older Intel Macs |
| Windows MSI | shellyard-windows-amd64.msi | Recommended — installs cleanly, registers an uninstaller |
| Windows portable | shellyard-windows-amd64.zip | No-install zip |
Linux .deb | shellyard-linux-amd64.deb | Debian, Ubuntu, Mint, Pop!_OS |
Linux .rpm | shellyard-linux-amd64.rpm | Fedora, RHEL, CentOS, openSUSE |
| Linux AppImage | shellyard-linux-amd64.AppImage | Distro-agnostic, single-file, kiosk / portable |
Linux .zip | shellyard-linux-amd64.zip | Portable fallback when you can’t run a package manager |
Verify
Every release publishes a GPG-signed SHA256SUMS.asc you can verify against the public key at releases.shellyard.com/release-pubkey.asc:
curl -sLO https://releases.shellyard.com/v<v>/SHA256SUMS
curl -sLO https://releases.shellyard.com/v<v>/SHA256SUMS.asc
gpg --verify SHA256SUMS.asc SHA256SUMS
sha256sum -c SHA256SUMS --ignore-missingmacOS (until 2026-05-08)
The first launch shows a Gatekeeper warning (“ShellYard.app is damaged and can’t be opened”). Strip the quarantine attribute once:
xattr -d com.apple.quarantine /Applications/ShellYard.appAfter that, double-click works normally. After 2026-05-08 the notarized build skips this entirely.
Windows (until 2026-05-08)
SmartScreen warns “Unknown publisher” on first launch of the MSI. Click More info → Run anyway. After one approval, future launches don’t prompt. Once Authenticode signing lands, this prompt is gone.
Linux — Debian / Ubuntu (.deb)
sudo apt install ./shellyard-linux-amd64.debapt resolves the WebKit2GTK + GTK3 dependencies for you. sudo dpkg -i … works too if you don’t mind chasing dependencies by hand.
Linux — Fedora / RHEL (.rpm)
sudo dnf install ./shellyard-linux-amd64.rpmOn openSUSE use sudo zypper install ./shellyard-linux-amd64.rpm.
Linux — AppImage
chmod +x shellyard-linux-amd64.AppImage
./shellyard-linux-amd64.AppImageSingle-file, no install, no package manager. Requires FUSE on the host (preinstalled on most distros). Good for kiosk / portable / locked-down environments.
Linux — portable .zip
unzip shellyard-linux-amd64.zip
sudo mv shellyard /usr/local/bin/
sudo chmod +x /usr/local/bin/shellyard
shellyardYou’ll need libwebkit2gtk-4.1-0 and libgtk-3-0 on the host (or the RPM equivalents webkit2gtk4.1 and gtk3). The package builds above pull these in for you — the .zip is the manual-install fallback.