Beta Installation Guide

During the beta, Pantry is not codesigned. This means your operating system will show a security warning when you first try to open it. This is normal — it happens with any app that hasn't been submitted to Apple or Microsoft for verification.

Once you complete the steps below, you only need to do it once. After that, Pantry will open normally.

Why isn't Pantry codesigned? Codesigning requires an Apple Developer account ($99/year) and a Microsoft code signing certificate (around $300/year). For a free beta of a solo project, that's a meaningful cost. Codesigning is planned for the full release.

macOS (Tahoe)

When you try to open Pantry for the first time, macOS will show a dialog saying the app "is damaged and can't be opened" or that it's "from an unidentified developer". It will offer to move it to the Trash. Don't do that.

The "Open Anyway" button that used to appear in System Settings -> Privacy & Security has been removed in recent macOS versions. You'll need to use a short Terminal command instead.

Steps

  1. Move Pantry.app to your Applications folder.
  2. Open Terminal (you can find it via Spotlight — press Cmd + Space and type "Terminal").
  3. Paste the following command and press Enter: 
    xattr -cr /Applications/Pantry.app
  4. Enter your password when prompted.
  5. Open Pantry normally. The security warning will not appear again.

What does this command do? When you download a file from the internet, macOS tags it with a "quarantine" flag. This flag is what triggers the security check. The command above removes that flag from Pantry so macOS stops blocking it.

Windows

When you try to run Pantry for the first time, Windows Defender SmartScreen will show a blue warning screen saying "Windows protected your PC" and that it prevented an unrecognized app from starting. You'll only see a "Don't run" button at first.

Steps

  1. On the SmartScreen warning, click "More info" (the small text link below the warning message).
  2. A "Run anyway" button will appear. Click it.
  3. Pantry will open. The warning will not appear again for this file.

Alternatively, you can right-click the downloaded .exe file, select Properties, check the "Unblock" checkbox at the bottom of the General tab, and click Apply. Then launch Pantry normally.

Linux

Linux does not have the same kind of app signing restrictions. If the downloaded file isn't executable, open a terminal and run:

chmod +x Pantry.AppImage

Then launch it normally.