Skip to main content
Version: v1.0.2 (stable)

Building Nym

Nym runs on Mac OS X, Linux, and Windows. All nodes except the Desktop Wallet on Windows should be considered experimental - it works fine if you're an app developer but isn't recommended for running nodes.

Building Nym​

Nym has two main codebases:

  • the Nym platform, written in Rust. This contains all of our code except for the validators.
  • the Nym validators, written in Go.

This page details how to build the main Nym platform code. If you want to build and run a validator, go here instead.


  • (Debian/Ubuntu) pkg-config, build-essential, libssl-dev, curl, jq
sudo apt update
sudo apt install pkg-config build-essential libssl-dev curl jq
  • Rust & cargo >= v1.56

We recommend using the Rust shell script installer. Installing cargo from your package manager (e.g. apt) is not recommended as the packaged versions are usually too old.

If you really don't want to use the shell script installer, the Rust installation docs contain instructions for many platforms.

Download and build Nym binaries​

The following commands will compile binaries into the nym/target/release directory:

rustup update
git clone
cd nym
git reset --hard # in case you made any changes on your branch
git pull # in case you've checked it out before

# Note: the default branch you clone from Github, `develop`, may be
# incompatible with both the mainnet and testnet. As such, make sure
# to checkout the current release:
git checkout tags/nym-binaries-1.0.2 # git commit c7fdcf0a79d7adfe45e879f152a90e6fa0bfc29e

# this builds your binaries with mainnet configuration
cargo build --release
# to build your binaries with Sandbox testnet configuration, run this instead:
NETWORK=sandbox cargo build --release

Quite a bit of stuff gets built. The key working parts are:

  1. the mixnode: nym-mixnode
  2. the gateway node: nym-gateway
  3. the websocket client: nym-client
  4. the socks5 client: nym-socks5-client
  5. the network requester: nym-network-requester
  6. the network explorer api: explorer-api

The repository also contains two Typescript applications which aren't built in this process: the Nym Wallet and the Network Explorer UI. Both of these can be built by following the instructions on their respective docs pages.


You cannot build from GitHub's .zip or .tar.gz archive files on the releases page - the Nym build scripts automatically include the current git commit hash in the built binary during compilation, so the build will fail if you use the archive code (which isn't a Git repository). Check the code out from github using git clone instead.