Installation

Minimum System Requirements

Linux (amd64): glibc version 2.14 or later (e.g., Ubuntu 12.04+, Debian 8+, RHEL/CentOS 7+).
macOS (Apple Silicon): macOS 11 (Big Sur) or later.
Windows: Windows 10 or later with Windows Subsystem for Linux 2 (WSL2) and a compatible Linux distribution with glibc version 2.14 or later.

Homebrew (recommended)

Install NEX via the official Homebrew tap. Make sure Homebrew is installed in your system.

Install

brew tap ChipNexus/nex
brew install nex

Upgrade

brew update
brew upgrade nex

Verify installation

Before first run

Ensure your license is properly configured before launching NEX for the first time. See the license setup guide for step‑by‑step instructions.

nex --version

Uninstall

brew uninstall nex

To remove the tap entirely:

brew untap ChipNexus/nex

Manual Installation

Manual installation considerations

Manual installation is recommended only when Homebrew is not available or cannot be used in your environment.

Updates must be performed manually. As a result, you may miss important feature releases, performance improvements, and critical bug fixes unless you regularly check for new versions.

You can install NEX manually by downloading the appropriate binary from the official Releases page.

Steps

Download the latest release archive for your platform.
(Optional) Verify the archive integrity using the provided SHA256 checksum. Example:
```
shasum -a 256 nex_<version>_<platform>.tar.gz
```
Compare the output with the SHA256 value published in the release notes.
Extract the .tar.gz archive.
Move the nex binary to a directory in your system PATH (for example, /usr/local/bin on macOS/Linux).
Confirm the installation:
```
nex --version
```
If the command is not found, ensure the destination directory is included in your PATH.

To uninstall NEX, remove the nex binary and any associated configuration files (see setup).