Skip to content

Docker node

Roy Keene edited this page Jan 23, 2019 · 21 revisions

Docker Pulls

The fastest way to set up a Nano node is via a docker container from DockerHub. You'll need a semi-recent version of Docker, Client Version ~ 1.5.0.

Installation instructions

Pulling Docker image

Live Network

docker pull nanocurrency/nano

Beta Network

docker pull nanocurrency/nano-beta


Live Network

docker run -d -p 7075:7075/udp -p 7075:7075 -p [::1]:7076:7076 -v ~:/root --restart=unless-stopped nanocurrency/nano

Beta Network

docker run -d -p 54000:54000/udp -p 54000:54000 -p [::1]:55000:55000 -v ~:/root --restart=unless-stopped nanocurrency/nano-beta

This command:

  • Starts the docker container as a daemon -d
  • Maps the network activity port -p 7075:7075/udp
  • Maps the bootstrapping TCP port -p 7075:7075
  • Maps the RPC control port to the local adapter only -p [::1]:7076:7076
  • Maps the host's home directory to the guest /root directory ~:/root
  • Restarts the container if it crashes --restart=unless-stopped
  • Specifies the container to execute (nanocurrency/nano for the Live network nanocurrency/nano-beta for the Beta network)

This will put the data in a permanent location in your hosts's home directory, outside the docker container.


If you get Error starting userland proxy: port is not a proto:IP:port: 'tcp:[:'. or want to expose IPv4 port, use -p

If you get create ~: volume name is too short, names should be at least two alphanumeric characters. replace the ~ with the full pathname such as /Users/someuser.

Setting up a wallet and adding accounts

You'll need the container ID for the following commands. You can get it with docker ps e.g. d9416b274092. Replace <CONTAINERID> with that ID.

First create a new wallet:

docker exec <CONTAINERID> /usr/bin/nano_node --wallet_create

You should get a wallet ID which you need in the next step.

docker exec <CONTAINERID> /usr/bin/nano_node --account_create --wallet=<WALLETID>

You get a new Nano address starting with xrb_1234… back.

To get your seed execute:

docker exec <CONTAINERID> /usr/bin/nano_node --wallet_decrypt_unsafe --wallet=<WALLETID>

More information about the wallet backup is available here: Wallet Backups

RPC interface

You can use the RPC interface on the local host via curl.

For example the version of the node:

curl -d '{ "action" : "version" }' [::1]:7076

Or the blockcount:

curl -d '{ "action" : "block_count" }' [::1]:7076

All available RPC commands are listed here: RPC protocol


To update your container you need to rebuild it.

Make sure that you have your seed backup up!

First stop your old container:

docker stop <CONTAINERID>

Then remove it:

docker rm <CONTAINERID>

Then pull the new image and run the image just like you did at first start.


You can find reference material for using docker here:

You can create a custom name for your container at the docker runcommand by adding e.g. --name nanonode.

Once set up, using bashrc to create an alias can save you time.

For example (when nanonode is the name your docker container):

docker exec nanonode /usr/bin/nano_node --diagnostics

Can be shortened to:

nano-node --diagnostics

By editing ~/.bashrc to add the alias:

alias nano-node='docker exec nanonode /usr/bin/nano_node'

You can’t perform that action at this time.