Skip to main content

Desktop Install

PilotDeck provides a native macOS desktop app based on Electron. The current build supports Apple Silicon (arm64).

Standard Install​

  1. 1
    Download and open the DMG

    Download the latest macOS installer from GitHub Latest Release.

  2. 2
    Move it into Applications

    Drag PilotDeck.app into the Applications folder.

  3. 3
    Launch

    Open PilotDeck from Launchpad or Finder.

提示 · Info

The homepage reads the latest installer URL from the GitHub Releases API. This docs link uses GitHub's releases/latest redirect, so it automatically opens the newest release without editing the website each time.

Fix for DMG Files Received Through IM Apps​

注意 · Warning

If you received the DMG file through sandboxed IM apps such as Feishu, WeChat, or QQ, macOS 14 (Sonoma) and later may reject the app because of the com.apple.provenance extended attribute, even when the code signature and notarization are valid.

Option 1: Run the Fix Script​

bash install-pilotdeck.sh

The script will:

  1. Find the installed PilotDeck.app
  2. Clear macOS quarantine/provenance extended attributes
  3. Verify code signing and Apple notarization

Option 2: Fix Manually​

# Clear extended attributes
xattr -cr /Applications/PilotDeck.app

# Launch again
open /Applications/PilotDeck.app
提示 · Info

Technical background: macOS Sonoma introduced the com.apple.provenance extended attribute. Files downloaded by sandboxed apps such as Feishu or WeChat may be marked with this attribute, causing Gatekeeper to apply stricter policy checks. xattr -cr is safe here: Apple's notarization ticket is stored in Contents/CodeResources, not in extended attributes.

Configuration​

After the desktop app starts, it launches the embedded PilotDeck Gateway service. The config path is the same as the Web version:

~/.pilotdeck/pilotdeck.yaml

On first launch, the app guides you through API key setup. For details, see Config File Reference.

Next Steps​

Web Install

You can also use PilotDeck through the Web flow

Core Features

Learn about PilotDeck's core capabilities