How to Install LocalSynapse on macOS (Gatekeeper Workaround)
LocalSynapse runs on macOS 12 and later, on both Intel and Apple Silicon Macs. But because the app is not signed with an Apple Developer certificate, macOS Gatekeeper will refuse to open it on first launch with a message like "LocalSynapse is damaged and can't be opened" or "developer cannot be verified". Here's how to install it safely.
Step 1 — Download the right .dmg
Go to localsynapse.com, enter your email, and you'll see two macOS download links:
- macOS (Apple Silicon) — for M1, M2, M3, M4 Macs (most Macs sold after late 2020).
- macOS (Intel) — for older Intel-based Macs.
Not sure which one you have? Click the Apple menu → About This Mac. If you see "Apple M1/M2/M3/M4" under Chip, get the Apple Silicon build. If you see "Intel Core...", get the Intel build.
Step 2 — Mount the .dmg and drag to Applications
Double-click the downloaded .dmg file. A window will open showing the LocalSynapse app icon and an Applications folder shortcut. Drag the app onto the Applications folder. Eject the .dmg.
Step 3 — First launch: bypass Gatekeeper
This is the part that trips people up. If you double-click LocalSynapse like a normal app, macOS will block it. You have two options:
Option A: Control+Click → Open (the easy way)
- Open the Applications folder in Finder.
- Control+Click (or right-click) the LocalSynapse icon.
- Choose Open from the menu.
- A warning dialog appears. Click Open again.
That's it. macOS now trusts the app and you can launch it normally from now on.
Option B: Terminal (one-liner)
If Option A doesn't work, or you prefer the command line, open Terminal and run:
xattr -cr /Applications/LocalSynapse.app
This removes the quarantine attribute that macOS attaches to apps downloaded from the internet. After running this, you can launch LocalSynapse normally with a double-click.
Why is the Gatekeeper warning showing?
macOS Gatekeeper checks every new app for two things: a valid Developer ID signature, and notarization (Apple has scanned the app for malware). LocalSynapse uses ad-hoc code signing for now — it's signed, but not with an Apple Developer ID, so Gatekeeper treats it as untrusted on first launch.
Apple Developer notarization costs $99/year. We're a free, open-source project, and we'd rather put that toward something users actually feel. The workarounds above let you verify and trust the app yourself — which is functionally the same thing Gatekeeper does, just with you in the loop.
Is it safe?
LocalSynapse is open source under Apache 2.0. You can read every line of code at github.com/LocalSynapse/LocalSynapse. The releases on GitHub include SHA-256 checksums (SHA256SUMS-macOS.txt) — you can verify the file you downloaded matches what was built and published. Once installed, the app makes zero outbound network calls during search.
System requirements
- macOS 12 (Monterey) or later
- Apple Silicon (M1+) or Intel (x64)
- 8 GB RAM recommended (4 GB minimum)
- ~500 MB disk including the AI model
Once installed, LocalSynapse scans your home directory and builds the search index in the background. You can start searching filenames immediately; content search becomes available as indexing progresses.