Install issues
Fix problems installing or updating Proliferate.
Use this page when the Proliferate desktop app will not download, open, or update correctly on your Mac.
Proliferate ships as a signed macOS app today, distributed as a .dmg. If
you're on Windows or Linux, there isn't a native build yet.
Check:
- You downloaded the build that matches your Mac. Download
defaults to Apple Silicon (M-series). Add
?arch=x64to the download link if you're on an Intel Mac. - The app is in
/Applications, not still sitting in your Downloads folder. Running it from Downloads works once, but auto-update and file access behave better from/Applications. - macOS let the app open. The first launch of a freshly downloaded app can trigger Gatekeeper's "cannot verify developer" prompt. Right-click the app and choose Open, or approve it under System Settings → Privacy & Security.
- The app has permission to read the folders where your repositories live. macOS gates access to folders like Documents or Desktop the first time an app touches them; approve the prompt, or move your checkouts somewhere Proliferate already has access to.
- The desktop updater isn't blocked by network policy. Proliferate checks for updates automatically; a corporate proxy or firewall that blocks outbound requests can silently stall updates.
macOS Gatekeeper first-launch prompt
The 'Apple could not verify... is free of malware' dialog shown the first time you open a freshly downloaded Proliferate.app, with Cancel and Open (or Move to Trash) actions.
Downloading a new .dmg doesn't require you to delete the old app first.
Dragging the new version into /Applications overwrites it and keeps your
workspaces, settings, and connected repositories.
If the app opens but setup checks fail once you're inside, continue with agent credential issues or Git and PR issues.