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

    Go to the PilotDeck v0.0.9 Release page, download the Apple Silicon DMG file, then double-click the downloaded file.

  2. 2
    Move it into Applications

    Drag PilotDeck.app into the Applications folder.

  3. 3
    Launch

    Open PilotDeck from Launchpad or Finder.

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