NOIR Documentation
Search…
Noirnode Setup Guide
Disclaimer
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.
Prerequisites
- 1.
- 2.25,000 Noir
- 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.At least 2 GB of RAM
- 2.At least 20 GB of storage space
- 3.A static public IP address
- 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.
1
noirnode genkey
Copied!
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.
1
getaccountaddress NN1
Copied!
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:
1
noirnode outputs
Copied!
You should see the something similar to the example below:
1
{ "d8ff88888bb6d9998d22c5155437f009c72dfd55dd2222f87fd55e22c0f89ddc" : "1", }
Copied!
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 called
noirnode.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 INDEXWhere:
- LABEL: The label of the node used for
getaccountaddresscommand above. - IP: Your VPS public IP address.
- NOIRNODEKEY: Noirnode key previously generated with the
noirnode genkeycommand. - TXID: The Transaction ID obtained using the
noirnode outputscommand above. - INDEX: The Index obtained using the
noirnode outputscommand 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 [email protected]). 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 usernameServer Configuration
Install Necessary Packages
The following packages are mandatory to successfully setup a Noirnode:
1
sudo apt-get update
2
sudo apt-get upgrade
3
sudo apt-get install build-essential libtool autotools-dev automake pkg-config
4
sudo apt-get install libssl-dev libevent-dev bsdmainutils libboost-all-dev
5
sudo apt-get install software-properties-common
6
sudo apt-get install dirmngr --install-recommends
7
sudo add-apt-repository ppa:bitcoin/bitcoin
8
sudo apt-get update
9
sudo apt-get install libdb4.8-dev libdb4.8++-dev
10
sudo apt-get install libminiupnpc-dev libzmq3-dev
11
sudo apt-get install libqt5gui5 libqt5core5a libqt5dbus5
12
sudo apt-get install qttools5-dev qttools5-dev-tools libprotobuf-dev protobuf-compiler libqrencode-dev
Copied!
Next, we will install and configure UFW, a firewall for Linux:
1
sudo apt-get install ufw
2
ufw allow ssh/tcp
3
ufw limit ssh/tcp
4
ufw allow 8255/tcp
5
ufw logging on
6
ufw enable
Copied!
Download, Build & Configure the Noir Wallet
First, clone the latest version of the Noirwallet into your home directory
1
cd ~
2
git clone https://github.com/noirofficial/noir
Copied!
Next, we will build the wallet. These steps will take some time to complete, so please be patient:
1
cd noir
2
./autogen.sh
3
./configure --without-gui --enable-wallet
4
make
Copied!
Once the installation is complete, we need to set up the Noir configuration files:
1
mkdir ~/.noir
2
nano ~/.noir/noir.conf
Copied!
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.1configuration 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.
1
rpcuser=<username>
2
rpcpassword=<password>
3
rpcallowip=127.0.0.1
4
port=8255
5
rpcport=8822
6
listen=1
7
server=1
8
daemon=1
9
logtimestamps=1
10
maxconnections=64
11
txindex=1
12
nnode=1
13
externalip=<noirnode-ip-address>:8255
14
nnodeprivkey=<noirnode-key>
Copied!
Press Ctrl+X to save and y to confirm.
Next, start noird daemon and let it sync:
1
cd src
2
./noird
Copied!
You can check the status of syncing by typing:
./noir-cli getinfoCheck 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.
Last modified 1yr ago