Skip to Content
NeocodeInstalling NeoCode

Installing NeoCode

Download NeoCode for your platform and start managing your NeoEngine node.

Download

Visit the releases page  to download the latest version.

macOS

Download the installer

Download NeoCode_x.x.x_aarch64.dmg (Apple Silicon) or NeoCode_x.x.x_x64.dmg (Intel).

Open the DMG

Double-click the downloaded file to mount it.

Drag to Applications

Drag NeoCode to your Applications folder.

First Launch

Right-click NeoCode and select “Open” to bypass Gatekeeper on first launch.

On first launch, macOS may show a security warning. Right-click the app and select “Open” to allow it.

Windows

Download the installer

Download NeoCode_x.x.x_x64-setup.exe or NeoCode_x.x.x_x64_en-US.msi.

Run the installer

Double-click the downloaded file and follow the installation wizard.

Launch

Find NeoCode in your Start menu or desktop shortcut.

Linux

Debian/Ubuntu:

# Download the .deb package
wget https://github.com/neoengine-labs/neoengine-labs/releases/download/v0.2.0/neocode_0.2.0_amd64.deb
 
# Install
sudo dpkg -i neocode_0.2.0_amd64.deb

Fedora/RHEL:

# Download the .rpm package
wget https://github.com/neoengine-labs/neoengine-labs/releases/download/v0.2.0/neocode-0.2.0-1.x86_64.rpm
 
# Install
sudo rpm -i neocode-0.2.0-1.x86_64.rpm

AppImage (Universal):

# Download
wget https://github.com/neoengine-labs/neoengine-labs/releases/download/v0.2.0/neocode_0.2.0_amd64.AppImage
 
# Make executable
chmod +x neocode_0.2.0_amd64.AppImage
 
# Run
./neocode_0.2.0_amd64.AppImage

Auto Updates

NeoCode checks for updates automatically on launch. When an update is available:

  1. A notification appears in the app
  2. Click to download and install
  3. Restart to apply the update

You can also manually check for updates via the menu or by pressing the update shortcut.

Verifying Downloads

All releases are signed. Verify the signature:

# macOS/Linux
minisign -Vm NeoCode_x.x.x.dmg -P <public-key>

The public key is available on the releases page.

Uninstalling

macOS: Drag NeoCode from Applications to Trash.

Windows: Use “Add or Remove Programs” in Settings.

Linux:

# Debian/Ubuntu
sudo apt remove neocode
 
# Fedora/RHEL
sudo dnf remove neocode

Troubleshooting

App won’t open on macOS

If you see “NeoCode is damaged and can’t be opened”:

xattr -cr /Applications/NeoCode.app

Missing dependencies on Linux

Install required libraries:

# Ubuntu/Debian
sudo apt install libwebkit2gtk-4.1-0 libgtk-3-0
 
# Fedora
sudo dnf install webkit2gtk4.1 gtk3

Firewall issues

NeoCode needs to communicate with local services. Ensure your firewall allows:

  • Localhost connections (127.0.0.1)
  • Ports used by NeoEngine services (configurable)
CommandsInterface Guide