Shell script to install a Beacon Coin Masternode on a Linux server running Ubuntu 16.04.
Supports IPv4, IPv6 and a single master node per single VPS.
The installation script will do everything needed to setup your VPS with the latest updates and perform all steps required to install the Beacon masternode without any interaction or programming knowledge.
When you run the script it will tell you what it will do on your system. Once completed there is a summary of the information you need to be aware of regarding your node setup which you can copy/paste to your local PC.
Make sure you keep the script output information safe for later.
Never show or tell anyone what your private key is or they can steal your coins.
You will need to run the script before setting up your node in your local wallet as it will generate a private key for you to use in your masternode.conf file.
To get started with the installation, login to your VPS as the root user and run the two lines below.
wget https://raw.githubusercontent.com/click2install/beacon/master/install-beacon.sh
bash install-beacon.sh
Run the script first so you have the information when it finishes, to complete your cold wallet setup.
The script assumes you are running a cold wallet on your local PC and this script will execute on a Ubuntu Linux server. The steps involved are:
- Run the masternode installation script as per the instructions above.
- When you are finished this process you will get some information on what has been done as well as some important information you will need for your cold wallet setup.
- Copy/paste the output of this script into a text file and keep it safe.
You are now ready to configure your local wallet and finish the masternode setup:
- Make sure you have downloaded the latest wallet from https://github.com/beaconcrypto/beacon/releases
- Install the wallet on your local PC
- Start the wallet and let it completely synchronize to the network - this will take some time
- Create a new
Receiving Addressfrom the walletsFilemenu and name it appropriately, e.g. MN-1 - Unlock your wallet and send exactly 10,000 BCN to the address created in step #4
- Wait for the transaction from step #5 to be fully confirmed. Look for a tick in the first column in your transactions tab
- Once confirmed, open your wallet console and type:
masternode outputs - Open your masternode configuration file from the wallets
Toolsmenu item. - In your masternodes.conf file add an entry that looks like:
[address-name from #4] [ip:port of your VPS from script output] [privkey from script output] [txid from from #7] [tx output index from #7]- - Your masternodes.conf file entry should look like:
MN-1 127.0.0.2:11115 93HaYBVUCYjEMeeH1Y4sBGLALQZE1Yc1K64xiqgX37tGBDQL8Xg 2bcd3c84c84f87eaa86e4e56834c92927a07f9e18718810b92e0d0324456a67c 0and it must be all on one line in your masternodes config file. Make sure there are no blank lines in the file and no leading or trailing spaces on any of the lines in the file. Do not copy/paste from MS Word, if you are pasting any content use a plain text editor like Notepad, Textpad, etc. or you may get errors when the wallet starts. - Save and close your masternodes.conf file
- Close your wallet and restart
- Go to Masternodes
- Click the row for the masternode you just added
- Right click the masternode row, then click Start Alias
- Your node should now be running successfully, wait for some time for it to connect with the network and the
Activetime to start counting up.
Because the masternode runs under a user account, you cannot login as root to your server and run commands like beacon-cli masternode status, if you do you will get an error. You need to first switch to the beacon-mn1 user. So make sure you keep the output of the script after it runs.
Each time you run the script to install a node it will automatically create a new beacon-mn1 user for the node to run under.
The masternode runs as a service, so if you do not stop the service and just try to stop the daemon process, it will restart again. You can start and stop the masternode when logged in as root or the beacon-mn1 user by running the following two commands:
systemctl stop beacon-mn1.service
systemctl start beacon-mn1.service
su - beacon-mn1
If you are asked for a password, it is in the script output you received when you installed the masternode, you can right click and paste the password (which will not be shown), then press Enter.
The following commands can then be run against the node which is running as the beacon-mn1 user.
beacon-cli masternode status
beacon-cli getinfo
beacon-cli mnsync status
If something goes wrong with your installation or you want to remove the masternode, you can do so with the following command.
userdel -r beacon-mn1
This will remove the user and its home directory. You then re-run the installation script and it will re-create everything for the beacon-mn1 user.
The script will set up the required firewall rules to only allow inbound node communications, whilst blocking all other inbound ports and all outbound ports.
The fail2ban package is also used to mitigate DDoS attempts on your server.
Despite this script needing to be run as root you should secure your Ubuntu server as normal with the following precautions:
- disable password authentication
- disable root login
- enable SSH certificate login only
If the above precautions are taken you will need to su root before running the script. You can find a good tutorial for securing your VPS here.
Whilst effort has been put into maintaining and testing this script, it will automatically modify settings on your Ubuntu server - use at your own risk. By downloading this script you are accepting all responsibility for any actions it performs on your server.