Noirnode Setup Guide
Last updated
Last updated
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.
Noir Core Wallet v2.1.0.3 or later: See Github for the latest release and release notes.
25,000 Noir
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:
At least 2 GB of RAM
At least 20 GB of storage space
A static public IP address
Secure the Wallet: This is optional but highly recommended. How to Securing the Noir Wallet for details.
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.
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.
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:
You should see the something similar to the example below:
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 IP:8255 NOIRNODEKEY TXID INDEX
Where:
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
The following packages are mandatory to successfully setup a Noirnode:
Next, we will install and configure UFW, a firewall for Linux:
It is also recommended that you further harden your server with AppArmor or SELinux, Fail2Ban, and other common best practices as suggested here.
First, clone the latest version of the Noirwallet into your home directory
Next, we will build the wallet. These steps will take some time to complete, so please be patient:
Once the installation is complete, we need to set up the Noir configuration files:
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=127.0.0.1 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:
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.
