Comment on page

Noirnode Setup Guide


Noir team is not in any way responsible if you don't provide a necessary hardening level to your VPS/Servers. We try to make everything simple and super easy, but if you fail to implement some basic and/or Advanced Security Level in your Noirnodes we are not responsible if disasters happen.
If you not feel confident in setting up, running and mantain your Noirnodes, you can contact a Trusted 3rd-party service as Zednodes and let them do everything for you.


  1. 1.
    Noir Core Wallet v2.1.0.3 or later: See Github for the latest release and release notes.
  2. 2.
    25,000 Noir
  3. 3.
    A Virtual Private Server (VPS): A VPS is recommend as a Noirnode requires dedicated resources and 24x7 availability for proper operation. Although it is possible, in theory, to run a Noirnode from your desktop, this guide will not walk through those steps. The VPS must have:
    1. 1.
      At least 2 GB of RAM
    2. 2.
      At least 20 GB of storage space
    3. 3.
      A static public IP address
  4. 4.
    Secure the Wallet: This is optional but highly recommended. How to Securing the Noir Wallet for details.

Generating a Noirnode Key

This section describes how to generate a Noirnode key from a desktop wallet. You can associate a desktop wallet address with a Noirnode on a separate server, which this section describes.
First, launch your desktop wallet and navigate to Help --> Debug Window --> Console as shown in the screenshot below:
In the console, enter the following command. This generates the Noirnode key. Be sure to save it to a safe location.
noirnode genkey
Next, enter the following command to generate a Noirnode deposit address for the 25,000 Noir collateral. NN1 will be the label assigned to the new deposit address and can be changed if desired.
getaccountaddress NN1
After generating the Noirnode key and Noirnode wallet address, transfer the collateral deposit of 25,000 Noir. Be aware that you must send exactly 25,000 Noir in a single transaction. Also consider that a transaction fee will be deducted.
Once you have sent the 25,000 Noir to the address generated from getaccountaddress, you will need to obtain the transaction ID and index.
Do this by navigating to Help --> Debug Window --> Console as shown in the screenshot above.
Type the following into the Console to obtain your Transaction ID and Index:
noirnode outputs
You should see the something similar to the example below:
{ "d8ff88888bb6d9998d22c5155437f009c72dfd55dd2222f87fd55e22c0f89ddc" : "1", }
From the example, we get the Transaction ID and Index:
  • Transaction ID: d8ff88888bb6d9998d22c5155437f009c72dfd55dd2222f87fd55e22c0f89ddc
  • Index: 1
Next, you will need to create a text file on the computer with the desktop wallet. Depending on your operating system, create a file callednoirnode.confand place it in the appropriate directory:
  • Windows:%APPDATA%
  • OS X: ~/Library/Application Support/noir
  • Linux: $HOME/.noir
In the file, add a line that matches the following syntax. If you are running multiple Noirnodes, you will add one line for each node with the appropriate values:
  • LABEL: The label of the node used for getaccountaddress command above.
  • IP: Your VPS public IP address.
  • NOIRNODEKEY: Noirnode key previously generated with the noirnode genkeycommand.
  • TXID: The Transaction ID obtained using the noirnode outputs command above.
  • INDEX: The Index obtained using the noirnode outputs command above.
Your file should look like this, except the first line which is there for visual reference. The file will only have one line.
Save the file and restart your wallet. The wallet is now configured for Noirnode and next we will setup and link the Noirnode server.
For the next steps, we'll be using Ubuntu Server 16.04 64-bit. You must use SSH to connect to your VPS. You can use PuTTY for Windows or Terminal on Mac OS X (ssh root@IP). So, let's login to our VPS with root user and create an extra user that we will later add to sudoers group. Login as root and create a new user: adduser username

Server Configuration

Install Necessary Packages

The following packages are mandatory to successfully setup a Noirnode:
sudo apt-get update
sudo apt-get upgrade
sudo apt-get install build-essential libtool autotools-dev automake pkg-config
sudo apt-get install libssl-dev libevent-dev bsdmainutils libboost-all-dev
sudo apt-get install software-properties-common
sudo apt-get install dirmngr --install-recommends
sudo add-apt-repository ppa:bitcoin/bitcoin
sudo apt-get update
sudo apt-get install libdb4.8-dev libdb4.8++-dev
sudo apt-get install libminiupnpc-dev libzmq3-dev
sudo apt-get install libqt5gui5 libqt5core5a libqt5dbus5
sudo apt-get install qttools5-dev qttools5-dev-tools libprotobuf-dev protobuf-compiler libqrencode-dev
Next, we will install and configure UFW, a firewall for Linux:
sudo apt-get install ufw
ufw allow ssh/tcp
ufw limit ssh/tcp
ufw allow 8255/tcp
ufw logging on
ufw enable
It is also recommended that you further harden your server with AppArmor or SELinux, Fail2Ban, and other common best practices as suggested here.

Download, Build & Configure the Noir Wallet

First, clone the latest version of the Noirwallet into your home directory
cd ~
git clone
Next, we will build the wallet. These steps will take some time to complete, so please be patient:
cd noir
./configure --without-gui --enable-wallet
Once the installation is complete, we need to set up the Noir configuration files:
mkdir ~/.noir
nano ~/.noir/noir.conf
Next, enter the following configuration. Be sure to update the following fields in <brackets>:
  • <username>: For example, noiruser
  • <password>: Any secure password, although the rpcallow= configuration prevents access outside the server itself.
  • <noirnode-ip-address>: The public IP address assigned to your server. Refer to your VPS provider documentation for details on how to assign and obtain your public IP address.
  • <noirnode-key>: The key of the wallet address that will be associated with your Noirnode as documented above.
Press Ctrl+X to save and y to confirm.
Next, start noird daemon and let it sync:
cd src
You can check the status of syncing by typing:
./noir-cli getinfo
Check the current block and compare it with the latest block of your synced core wallet, mining pool or Noir blockchain explorer. Finally, when it is fully synced, you can start your node from the desktop wallet. First, double check that your Noirnode addresses confirmed their 25,000 ZOI balance and that you restarted the Noir wallet after creating the Noirnode.conf file.
Next, in the wallet, go to the Masternodes tab and you should see a list of all Noirnodes on the network.
Click My Noirnodes in the bottom right to see the list of your Noirnodes that you added to Noirnode.conf.
Click the Start missing button to start all of your nodes.
Your nodes should show PRE_ENABLED in status and after a few minutes change to ENABLED.
If the status changes to EXPIRED, there is something wrong in your configuration and you will need to go back and double check every step you've made.