lpos-server.md

description
How to set up your own LPoS server.

LPoS Server

Manual Installation

This article will assume you are using a 64 bit Linux Virtual Private Server.

{% hint style="info" %} NOTICE: If you are using a Windows based server, the .zip releases contain nixd.exe and nix-cli.exe. Configuration steps will remain essentially the same, you'll just be using Windows commands and editors instead of the Linux ones used here. {% endhint %}

Log into your VPS using a Secure Shell (ssh) client according to your providers instructions. PuTTY is a popular ssh client that is open source and available for Windows and Unix/Linux for free.

If you are logging in as root, the first thing you will want to do is create a normal user. Running services as the root user is generally considered a bad practice. You can create a new user with:

useradd -m NEW_USERNAME_HERE

The following command will allow you to choose a password for your new username:

passwd NEW_USERNAME_HERE

Next, "substitute user" into your new user and its home directory using:

su - NEW_USERNAME_HERE

{% hint style="success" %} For future ssh connections, login as your normal user. {% endhint %}

Download the latest NIX Platform Core software release using wget:

wget https://github.com/NixPlatform/NixCore/releases/download/v3.0.8/nix-3.0.8-x86_64-linux-gnu.tar.gz

Unpack the file.

tar -zxvf nix-3.0.8-x86_64-linux-gnu.tar.gz

You will now need to be the root user to install the binary files. Use the substitute user command:

su

After entering in your root password, install the NIX binary files.

cp nix-3.0.8/bin/* /usr/bin/

You no longer need root permissions, so drop back down to your normal user with:

exit

Now that you are back into your normal user, start the NIX daemon and put it into the background.

nixd&

Now create your nix.conf file. This needs to be in the data directory, which by default is created as a hidden directory named .nix in the users home. Use the command:

nano .nix/nix.conf

For a minimal configuration, add the following lines to nix.conf:

{% code title="nix.conf" %}

daemon=1
minimumleasepercentage=1191
leaserewardaddresses=RewardAddress1,RewardAddress2,etc

{% endcode %}

{% hint style="success" %} TIP: Your reward address can be generated from the VPS wallet, but for best security practices it should be on a different wallet entirely. This way, there are never spendable coins on your LPoS Server. {% endhint %}

Using the above configuration, this wallet will only stake contracts with a fee no less than 11.91% and your specified reward address(es). For more advanced configurations, see Command-line options.

Exit and save the file by using 'Ctrl + x', pressing 'y' and hitting <Enter>

{% hint style="success" %} TIP: If you'd like to use this to privately cold stake your own coins, simply omit the 'minimumleasepercentage=' and 'leaserewardaddresses=' lines and create your LPoS client contract with no fee. {% endhint %}

Next, encrypt your wallet and choose a passphrase.

nix-cli encryptwallet YOUR_PASSPHRASE

After encryption nixd will automatically shut itself down. Restart the daemon.

nixd

{% hint style="info" %} NOTE: Now that you have 'daemon=1' in your nix.conf file, you will no longer need to append & to nixd in order to put the process into the background. {% endhint %}

Now you can generate a new address. This will be used for the "Lease To: " address field when creating a LPoS client contract. The following command will generate and store a new standard address (beginning with "N") to a text file named LeaseToAddress.txt:

nix-cli getnewaddress >> LeaseToAddress.txt

To create a "nix1" Bech32 address and add it to LeaseToAddress.txt, type:

nix-cli getnewaddress LPoS-Bech32 bech32 >> LeaseToAddress.txt

If you want to quickly view the contents of LeaseToAddress.txt, use:

cat LeaseToAddress.txt

{% hint style="success" %} TIP: Now would be a good time to download your wallet.dat, nix.conf and LeaseToAddress.txt files using PuTTY's pscp (putty secure copy) program to have a backup. {% endhint %}

Check to see that your wallet is syncd with:

nix-cli getblockcount

.. and compare the output with the networks current block number. If it continues to read zero, chances are it needs a little help finding a peer. To manually add a node, use:

nix-cli addnode sf.nixplatform.io add

Once you've confirmed your wallet is syncd, unlock it for staking with:

nix-cli walletpassphrase YOUR_PASSPHRASE 0 true

Your VPS wallet is now ready to accept contracts and begin staking.

Finally, delete your bash history to remove your passphrase from both the history file and system memory.

history -c;history -w

{% hint style="danger" %} If your VPS wallet contains spendable coins you should always execute this command before logging out any time you enter your password through the bash prompt in plain text. {% endhint %}

You can now close your ssh connection.

A couple of other useful commands..

To watch your debug file in real time, use:

tail -f .nix/debug.log

To stop nixd, use:

nix-cli stop

Automatic/Scripted Installation

Alternatively, you can also use the following method and utilize CryptoSharks' script:

These instructions will help guide you to setting up your own cold stake on a VPS. Log into the server using ssh (Putty for windows or terminal for Mac users) and run the following commands:

wget -q https://raw.githubusercontent.com/cryptosharks131/Ghostnode/master/nix_cold_stake.sh
bash nix_cold_stake.sh
nix-cli encryptwallet "create_password_here"
nix-cli getnewaddress
nix-cli walletpassphrase "put_your_password_here" 0 true

Now you may go to your local wallet and create a LPoS contract with the following details.
Lease To: This is the address you got from the VPS after running 'nix-cli getnewaddress'
Amount: The amount to place in the contract (subtract fee button can be used to take the contract writing fee from this amount)

You can now hit 'send nix' to confirm the contract and you are all set! Once the contract gets 200 confirms, your VPS will start staking!

Video: https://youtu.be/GwH5ysdfTrY