Install
Install ShellYard on macOS, Windows, or Linux. Workarounds for Gatekeeper and SmartScreen on unsigned builds. .deb, .rpm, AppImage, zip on Linux.
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 |
macOS — first launch (Gatekeeper)
If you downloaded an unsigned build, 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. Signed and notarized builds open without this prompt.
Windows — first launch (SmartScreen)
If you downloaded an unsigned build, SmartScreen may warn “Unknown publisher” on first launch of the MSI. Click More info → Run anyway. After one approval, future launches don’t prompt. Code-signed builds (Authenticode) don’t show this warning.
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.