Operators
Sandbox Testnet

Sandbox Testnet

Nym node operators can run their nodes in Nym Sandbox testnet environment. Whether it's testing new configuration, hot features from Nym developers or just trying to setup a node for the first time, this environment is for you.

Below are steps to setup your environment and an introduction to Sandbox token faucet.

ℹ️

This page is for Nym node operators. If you want to run NymVPN CLI over Sandbox testnet, visit NymVPN CLI Testnet guide (opens in a new tab).

Sandbox Environment Setup

ℹ️

Our documentation often refer to syntax annotated in <> brackets. We use this expression for variables that are unique to each user (like path, local moniker, versions etcetra). Any syntax in <> brackets needs to be substituted with your correct name or version, without the <> brackets. If you are unsure, please check our table of essential parameters and variables (opens in a new tab).

To run Nym binaries in Sandbox testnet, you need to get sandbox.env configuration file and point your binary to it. Follow the steps below:

1. Create Sandbox environment config file by saving this (opens in a new tab) as sandbox.env in the same directory as your binaries:
curl -o sandbox.env -L https://raw.githubusercontent.com/nymtech/nym/develop/envs/sandbox.env
  • In case you want to save the file elsewhere, change the path in '-o' flag
2. Run your nym-node with an additional flag -c or --config-env-file
  • Specify a path to sandbox.env
  • Add all needed commands and options - for example:

This example is for nym-node --mode mixnode.

./nym-node --config-env-file <PATH>/sandbox.env run --mode mixnode
  • In case you downloaded sandbox.env to same directory, <PATH> is not needed
3. Bond your node to Nym Sandbox environment

💡

  1. If you built Nym from source, you already have sandbox.env as a part of the monorepo (nym/envs/sandbox.env). Giving that you are likely to run nym-node from nym/target/release, the flag will look like this --config-env-file ../../envs/sandbox.env

  2. You can export the path to sandbox.env to your environmental variables:

export NYMNODE_CONFIG_ENV_FILE_ARG=<PATH>/sandbox.env

Sandbox Token Faucet

To run your nodes in Sandbox environment, you need testnet version of NYM token, that can be aquired from faucet.nymtech.net (opens in a new tab).

To prevent abuse, the faucet is rate-limited - your request will fail if the requesting wallet already has 101 NYM tokens.

Variables & ParametersPre-built Binaries