Skip to the article
NeuraCoreUser Wiki
← Back to this chapter
Start here

Install and update NeuraCore

NeuraCore installs with a single command on Linux, the Raspberry Pi, Windows and macOS, and updates with the rest of your computer afterwards.

One command

NeuraCore is installed with a single command: using your distribution's software repository on Linux, or a one-line installer script on Windows and macOS. You copy one line into a terminal and that is the whole installation.

The exact line for each system, together with what each one needs, is on the download page: https://download.neuracore.ch, it opens on the system you are using. On Windows, a one-line PowerShell command downloads and runs our installer script, installing NeuraCore into Program Files and creating desktop and Start Menu shortcuts, or you can download the portable zip archive directly.

Updating happens with everything else

NeuraCore never replaces itself. Because your software manager installed it, that same manager updates it: the command you already use to update your computer updates NeuraCore too.

When a newer version has been published, NeuraCore says so in the status bar at the bottom of its window. Clicking that message opens a small window with the exact command for the computer you are on.

Why it is safe

Every NeuraCore package is signed, and your software manager checks that signature before installing anything. A package altered on its way to you is refused rather than installed.

The download page carries the signing key and the installation script in full, on the page itself. Its “Checking that it is genuine” section holds one folded block for each: open one and the whole text unfolds where you are, with nothing to download and no file to open. Both can therefore be read before either is used.

Desktop integration

NeuraCore registers its embedded icon and application-menu entry automatically on Linux. On Windows, opening the release application does not create a terminal. On macOS, open NeuraCore.app in Finder. The application and its child windows use a dark background.

What your computer says the first time

NeuraCore is not yet signed with the certificates Microsoft and Apple sell to software publishers. A certificate says who published a program; it does not say whether the program is safe. Until NeuraCore carries one, both systems hold it back the first time you run it. Both are expected, both take one step to pass, and neither comes back afterwards.

On Windows, a blue window headed “Windows protected your PC” appears, offering only a “Don’t run” button. Click “More info”, which reveals a second button, then click “Run anyway”. The notice says the publisher is unknown, which is accurate: it means unidentified, not untrusted. Windows remembers your answer, so it asks once per version.

On macOS, the installer script clears the mark for you and NeuraCore opens normally. If macOS refuses anyway, saying it cannot check the application for malicious software, or if you unpacked the archive by hand, open Terminal and run: xattr -dr com.apple.quarantine /Applications/NeuraCore.app . That removes the quarantine mark macOS puts on everything downloaded, and NeuraCore then opens like any other application.

What protects you is not the certificate. On Linux every package is signed with NeuraCore’s own key and your software manager refuses one that was altered. On Windows and macOS the installer scripts verify the exact checksum of the files and refuse a download that does not match it. Install from https://download.neuracore.ch or the release it links to, and that check is doing its work whatever the operating system says.

Signing certificates are planned. When they arrive these warnings stop appearing on their own, with nothing for you to change.

On a Raspberry Pi

NeuraCore runs on a Raspberry Pi, and the download page has a card of its own for it with the one line to paste. The card comes up first when you open the page on the Pi itself.

It needs the 64-bit Raspberry Pi OS. Type uname -m in a terminal: aarch64 means you are ready, and armv7l or armv6l means you are on the 32-bit system, which NeuraCore is not published for. That is still the download most older boards get by default, so it is worth checking before anything else.

A Pi 4, Pi 5, Pi 400, Pi 500 or Pi Zero 2 W can run the 64-bit system. Reinstalling it with Raspberry Pi Imager, choosing the 64-bit edition, is the whole fix.

Afterwards NeuraCore is an ordinary package like anywhere else on Debian, and the command that updates the rest of the Pi updates it too. A Pi with no screen attached can run it as well: started with --headless it opens no window at all, which is what makes a board tucked behind a router worth using.