Downloading
Your download is starting.
While it finishes: your system will probably warn you the first time you open it. That is expected, and it is worth understanding why rather than just clicking through.
Windows will say it protected your PC
Neuron is not signed with a paid code-signing certificate, so Microsoft Defender SmartScreen does not recognise the publisher and blocks the installer on first run. It is a reputation check, not a virus scan — a brand-new certificate would trip it too.
Or avoid it entirely: the Microsoft Store build is signed by Microsoft after certification, so there is no warning to get past and the Store handles updates. It is the same application.
choco install neuron also works, from an elevated prompt.
Chocolatey checks the download against the checksums published with
the release before it runs anything — but the installer it runs is
the unsigned one, so this dialog can still appear.
You will see this
A blue dialog, with no obvious way forward. The button you need is hidden behind the link.
More info
- Click “More info”The small link in the dialog body. Nothing happens until you do — there is no “Run” button before this.
- Check the publisher lineIt should read
Unknown publisherand name the file you just downloaded. If it names something else, stop and delete it. - Click “Run anyway”This button only appears after step 1.
- Install as normalYou will not see this warning again for this version.
If you would rather verify first
Reasonable. Every release publishes SHA-256 checksums and a signed build provenance attestation, which proves which workflow and commit produced the file. Provenance is stronger than a signature here: a tampered installer can be re-signed, but it cannot be given GitHub's attestation.
# Proves this file came from Neuron's CI, not someone else gh attestation verify Neuron-win-x64.exe --repo neuron-workspace/Neuron
The Microsoft Store build is signed by Microsoft on submission, so once Neuron is listed there you will not see SmartScreen at all.
macOS will ask you to confirm before opening
Neuron is signed, but not notarized with an Apple Developer ID, so Gatekeeper stops the first launch and says “Neuron can’t be opened because it is from an unidentified developer”. That is the expected prompt for software Apple has not been paid to vouch for, and the steps below clear it permanently.
Or skip all of it: brew install --cask
neuron-workspace/neuron/neuron installs the same build without
the prompt. Homebrew clears the quarantine flag on casks it installed
itself, which is the supported way past Gatekeeper — unlike running
xattr by hand on something you did not build.
- Drag Neuron to ApplicationsOpen the .dmg and move the app across as usual.
- Right-click the app, then choose OpenRight-click — not a double-click. The same dialog appears, but this time it has an Open button.
- If there is still no Open buttonGo to System Settings → Privacy & Security, scroll to the Security section, and click Open Anyway next to the message about Neuron.
If it says “damaged” instead
That is a different message and it means something different. Builds before 0.4.4-beta.3 were packaged without ever being signed, so macOS was right to reject them — the bundle really was invalid, and Open Anyway will not help.
Download a current build rather than working around it. Clearing the quarantine flag on a genuinely broken bundle only hides the reason macOS stopped it.
Notarizing, which would remove the prompt above entirely, needs an Apple Developer account at $99/year that Neuron does not have.
Linux does not warn you — it just needs the right step
No signature prompt here. Which command you need depends on which file you downloaded.
AppImage
Self-contained, runs anywhere, no install. It only needs the executable bit.
chmod +x Neuron-*.AppImage ./Neuron-*.AppImage
Debian, Ubuntu and derivatives
sudo apt install ./Neuron-*.deb # resolves dependencies
If the AppImage will not start
On some distributions FUSE is missing. Install libfuse2, or
extract and run without it:
./Neuron-*.AppImage --appimage-extract-and-run