The easiest way to run a Waves Node is by using the new Waves Docker container. It requires just one command to enable everything or to change the settings of the node.
You need to install the latest version of Docker.
Please, follow installation istructions at Docker Site.
- This Docker image contains scripts and configs to run Waves Node from Version 0.13.0 for TESTNET, MAINNET or CUSTOM networks.
- The image is focused on fast and convenient deployment of Waves Node.
- Container downloads
.jarfile and configuration files from the releases section and runs it.
It is highly recommended to read more about Waves Node configuration before running the container.
The simplest way to run a container:
docker run -it wavesplatform/node
Note: We recommend to start a container like below for MAINNET:
docker run -p 6869:6869 -p 6868:6868 -e WAVES_NETWORK=MAINNET -e WAVES_LOG_LEVEL=DEBUG -e WAVES_HEAP_SIZE=2g -v YOUR_LOCAL_PATH_HERE:/waves wavesplatform/node
docker run -p 6869:6869 -p 6863:6863 -e WAVES_NETWORK=TESTNET -e WAVES_LOG_LEVEL=DEBUG -e WAVES_HEAP_SIZE=2g -v YOUR_LOCAL_PATH_HERE:/waves wavesplatform/node
You can run container with predefined environment variables:
||Plain text seed for node wallet. Container converts it to base58.|
||Base58 encoded seed.|
||Password for wallet file.|
||Node version. Default value is
||Available values are
||Node logging level, available values:
||Java Heap Size limit in -X Command-line Options notation (
||Path to your Waves Configuration file.|
||String with IP address and port to send as external address during handshake. Could be set automatically if UPnP is enabled. If
Note: All variables are optional.
The image supports config customization with env variables.
Depending on env values the image generates
local.conf file and stores it in
The simple rule of how to set a value in the configuration file:
- Determine the path to variable in configuration file (complete configuration file)
- Join all section names with two underscores(
- Replace all dashes with one underscore (
- Capitalize the final string.
For instance, if you want to set the value of
waves.rest-api.enable, pass an environment variable