Installation

Installation

Official builds live at sfg545.dev/orchard. Release files and SHA256SUMS.txt are mirrored at downloads.sfg545.dev/orchard.

Only install Orchard from the official website or the GitHub releases page. Verify the published checksum when you can.

Packages by platform

Platform	Packages
Windows	NSIS installer (x64)
Linux	AppImage, Flatpak, .deb, .rpm, Arch package (x86_64 and arm64)
macOS	ZIP for Apple Silicon and for Intel
Android	APK, see Orchard Mobile

Windows

Download the NSIS installer and run it. Current Windows builds are unsigned, so SmartScreen may show a "Windows protected your PC" prompt on first launch. Choose More info, then Run anyway, once you have verified the checksum.

The installer registers Orchard for automatic update checks. See Releases and Updates.

macOS

Download the ZIP matching your CPU (Apple Silicon or Intel), unzip it, and move Orchard.app into /Applications.

Current macOS builds are unsigned and unnotarized, so Gatekeeper will refuse the first launch. Right-click the app and choose Open, then confirm. If macOS still refuses, clear the quarantine attribute:

xattr -dr com.apple.quarantine /Applications/Orchard.app

Linux

Pick whichever package suits your distribution.

AppImage. Download, mark executable, run:

chmod +x Orchard-*.AppImage
./Orchard-*.AppImage

Flatpak. Install the bundle, then launch from your desktop menu:

flatpak install --user Orchard-*.flatpak
flatpak run dev.sfg.orchard

Debian and Ubuntu:

sudo apt install ./orchard_*.deb

Fedora and RHEL:

sudo dnf install ./orchard-*.rpm

Arch Linux:

sudo pacman -U orchard-*.pkg.tar.zst

Both x86_64 and arm64 builds are published for the AppImage and Flatpak.

Linux notes

• Orchard disables Chromium's HardwareMediaKeyHandling on Linux so that its own media-key handling works consistently across desktop environments.
• Discord Rich Presence needs Discord's IPC socket to be reachable. Under Flatpak, that usually means allowing access to $XDG_RUNTIME_DIR/discord-ipc-0.
• On Wayland, tray behavior depends on your desktop environment providing a StatusNotifier host. See Troubleshooting.

Verifying a download

sha256sum -c SHA256SUMS.txt --ignore-missing

Run this in the directory holding both the downloaded package and SHA256SUMS.txt.

Building it yourself

If you would rather compile from source, see Building from Source.