Node Setup


While you can run a Nano Node by downloading the binary or building from source, it is recommended to use a Docker Container. When using the official Docker Images, your node will be much easier to upgrade and maintain.

The guides found on this site make some basic assumptions about the read that should be understood before continuing:

  • You have a basic understanding of Docker.
  • You are using Nano's official Docker Images to manage your node. If you decide to use a different method, you will need to be able to fill in the gaps when following along.

Hardware Recommendations

  • 2GB RAM
  • Dual-Core CPU
  • A modern GPU to accelerate the Proof of Work if you are creating transactions at a high rate.

If a GPU can not be used on the machine that is running the node, the work can be outsourced to a remote work server.

Network Ports

rai_node will use two configurable ports throughout its lifecycle. In this guide we are using the default values that are suggested by the network specification:

  1. 7075 (UDP & TCP) - General communication with the Nano Network.
  2. 7076 (TCP) - Used for RPC Commands. Do not expose this outside of your production environment. Anyone with access to this port can control your rai_node's RPC.

Pulling The Docker Image

The docker image can be downloaded via docker pull. We can either grab the latest or a specific version/tag. Not specifying a tag defaults to latest. An example of each is found below.

# Pulls latest release of the Nano Node
sudo docker pull nanocurrency/nano
# Pulls the Nano Node tagged with "V13.0" from Dockerhub
# See:
sudo docker pull nanocurrency/nano:V13.0

If you are running in an enterprise environment, it is recommended that you explicitly specify the latest stable version to ensure deterministic containers. A list of tags can be found at the official Nano Currency dockerhub.