Install or update on Mac
Mac running the supported version of macOS. UI labels below are in English.
The download page shows the supported macOS version, both file formats, and the exact build number. Choose one file. The same app is packaged in both.
Verify your file
Section titled “Verify your file”- Download a DMG or ZIP from the exact release linked on the download page.
- In Terminal, go to the folder containing the file. Run the command shown next to your file on the download page, or run
shasum -a 256followed by a space and drag the downloaded file into the Terminal window. - Compare the printed hash with the expected value for that file. If it differs, discard the download and try again from the same GitHub release.
- If you downloaded both files and
SHA256SUMSinto the same folder, runshasum -a 256 -c SHA256SUMS.
Install
Section titled “Install”- DMG: Open the disk image and drag Stash into Applications. Eject the image afterward.
- ZIP: Extract the archive, then move
Stash.appto Applications. - For an update, export a backup, quit the running copy, and replace the application. Open Settings → About and check the version and build.
The development app is ad-hoc signed and not notarized. A matching hash confirms file integrity. macOS can still block the app. Check the message and follow Apple’s Gatekeeper guidance for the alert you received. Keep system protections enabled. Open first setup when the app launches.