Skip to content

Joining the beta network

A few common reasons for joining the beta network include:

  • Learning node setup and management
  • Testing out integrations for services build on Nano before running on the main network
  • Assisting in testing new node releases and features
  • Contributing to a network testing various behaviors and patterns with the protocol

Running a beta node is a great way to join in and help the network grow stronger.

Differences from the main network

Up to node v19.0, the main and beta networks had no functional differences. However, starting from v20.0, the following differences apply to the beta network.

Parameter Main Network Beta Network Comment
Proof of Work Difficulty Threshold 0xffffffc000000000 0xfffffc0000000000 16 times lower on the beta network

Node release testing

The beta network is also used to coordinate the testing of Nano node releases. The Nano Foundation maintains a few beta nodes on the network and various community members also setup nodes to help provide an environment more similar to the main network. Ahead of each release builds are published as Release Candidates (RC). Starting with RC1 and incrementing with each published build (RC2, RC3, etc.), these are intended for use on the beta network to help identify issues not discovered earlier in the development process.

We invite anyone interested in contributing to Nano to consider participating on the beta network. Not only is it beneficial to the ecosystem, it is also a great way to learn more about setting up and managing a node.

Warning

  • Release candidate builds are only recommended for use on the beta network
  • The fastest and most recommended method of installation is through Docker
  • Binaries and other details can be found at: https://beta.nano.org/

Running a beta node

Setting up a node on the beta network is similar to the main network. To start you should install docker and be familiar with the general setup and Docker management processes.

Network ports

Beta Network Ports Overview

  • 54000 UDP: For live network activity (fallback since V19.0)
  • 54000 TCP: For live network activity (since V19.0) and bootstrap network activity
  • 55000 TCP: For communication with RPC server. Anyone with access to this port can control your node's RPC.

Folder locations

OS Location
Windows C:\Users\<user>\AppData\Local\NanoBeta\
OSX /Users/<user>/Library/NanoBeta/
Linux /home/<user>/NanoBeta/

Info

Directory names for extracting builds downloaded from GitHub or https://beta.nano.org/ will be updated with RC versions for V19 and later.


Pulling the Docker image

Docker Pulls

Pulls the latest release of the Nano Node:

docker pull nanocurrency/nano-beta

Pulls a specific version of the Nano node:

docker pull nanocurrency/nano-beta:V19.0RC1

Pulls the latest release which includes any release candidate versions:

docker pull nanocurrency/nano-beta:latest-including-rc

A list of beta tags can be found at the official Nano Currency Docker Hub

Starting the Docker container

docker run --restart=unless-stopped -d \
  -p 54000:54000/udp \
  -p 54000:54000 \
  -p [::1]:55000:55000 \
  -v ${NANO_HOST_FOLDER_BETA}:/root \
  --name ${NANO_NAME} \
  nanocurrency/nano-beta:latest-including-rc

Tip

Separate host folders

Be sure to use a different host folder for main network and beta network Docker node setups. Attempting to use the same folder will result in issues.

Additional beta resources

URL Description
https://beta.nano.org/ Official beta site and faucet
https://beta.nanocrawler.cc/ Beta Explorer
https://b.repnode.org/ Beta nodes and Stats

Testing Builds

Release Candidate Builds

No Release Candidate (RC) builds are available for the beta network at this time.

Development Builds

Links for beta testing builds are shared in the #beta_announcements channel on our Discord server. Docker tags are also available on https://hub.docker.com/r/nanocurrency/nano-beta/tags.

Read-only Test Cases
Test Cases | TOML Config | DB Results | Generic Results
Last updated: 2019-10-11

If you are interested in helping test on beta and want to collaborate directly with the test cases spreadsheet, please connect with Zach - ATX#0646 or Dotcom#9351 in the #beta-net channel on our Discord server.