Installing Sentinel By Hand (Linux)

Installing Sentinel By Hand (Linux)

Sentinel Easy Installation Guide – For VIVO Masternodes

You must install Sentinel. Sentinel is a watchdog for your node which communicates to the network that your node is working properly.


Before starting the steps make sure to restart your masternode with reindex so you are using the fresh blockchain. Delete mncache.dat and mnpayments.dat from your vivocore folder before reindexing.

cd .vivocore   // Your Vivocore folder

./vivo-cli stop

rm mncache.dat

rm mnpayments.dat

./vivod -daemon -reindex


Wait for the full resync to the latest block. You can check regularly with


./vivo-cli getinfo


Once your wallet is fully synced you are now ready to follow the steps below. If you are running your masternodes on Linux you can now skip to Step 1) and start installing prerequisites.

 It is highly recommended to use a Linux system for your sentinel & masternode setup for a wide variety of reasons. Today it is easier than ever to switch to a Linux system, which is cheaper, far more efficient and controllable. If you have no experience in Linux, you have at your disposal two very easy to follow step-by-step guides (and video guides) that will completely assist you all the way from start to finish – the cold wallet guide (recommended) and the hot wallet guide. The guide below covers all areas for Linux users in detail, which represents over 90% of total masternode owners.


Step 1) Install the prerequisites
sudo apt-get update
sudo apt-get install -y git python-virtualenv
Step 2) If you are not already there, navigate to your .vivocore folder
cd .vivocore
Step 2) Clone sentinel, switch to the sentinel directory

git clone
cd sentinel


Step 3) Create virtual python environment


virtualenv venv

If this command fails try installing this package:):

sudo apt-get install -y virtualenv


Step 4) Install sentinel dependencies


venv/bin/pip install -r requirements.txt


Step 5) Test sentinel is alive and talking to the still syncing wallet


Open sentinel.conf:

nano sentinel.conf

Uncomment the #vivo_conf line at the top and add the path to your MN’s vivo.conf. Save the file then close it.

Now run:

venv/bin/python bin/


You should see: “vivod not synced with network! Awaiting full sync before running Sentinel.
This is exactly what we want to see at this stage


Step 6) Wait until the reindex has complete and the wallet has sync’d


cd .. (you should now be back in .vivocore)
./vivo-cli mnsync status

This is what you’re waiting to see:

AssetId 999, all trues, one false, and a FINISHED. Keep issuing ./vivo-cli mnsync status until it looks like this:


“AssetID”: 999,
“Attempt”: 0,
“IsBlockchainSynced”: true,
“IsMasternodeListSynced”: true,
“IsWinnersListSynced”: true,
“IsSynced”: true,
“IsFailed”: false


At this point, your remote masternode is synchronized and chatting with the network
but is not accepted as a masternode because it hasn’t been introduced to the network
by your collateral.


Step 7) You may now start your masternode! Go back to your local wallet, open the debug console, and run these commands (LABEL is the name you used for your MN in the masternode.conf):


walletpassphrase <YOURPASSPHRASE> 120
masternode start-alias <LABEL>


to (hopefully :)) start your masternode.


Step 8) Test sentinel has nothing bad to say


You’re needed back in Sentinel directory! :D

cd sentinel

At this point, running

venv/bin/python bin/

should return nothing but silence. This is how you know it’s working, and your masternode is working.


Step 9) Create a crontab entry to wake sentinel every five minutes


crontab -e


Choose Joe as your editor. Add this line to the end of the file.

* * * * * cd /home/YOURUSERNAME/.vivocore/sentinel && ./venv/bin/python bin/ 2>&1 >> sentinel-cron.log


Make sure you:
1) Change USERNAME to your username.
2) Hit enter to create another line at the end after this line, or the file will not work.


Press Control-K-X to save and exit.


Step 10) Check for start, try, try, again


cd ..


You should be back in .vivocore.


./vivo-cli masternode debug


Did it work? You should see the message “Masternode successfully started.”. Congratulations!


You can find more general documentation on Sentinel here. The simple, beginner-friendly sentinel guide has been originally contributed in the Dash KB by Tao.