KEEP — Random Beacon Node on VULTR

Here are the detailed steps from start to end on setting up KEEP Random Beacon Node on VPS. It would take about ~1 hr from start to end. Potentially can take longer if you get stuck in any of the below steps.

If you already have a Ubuntu VPS(server) ready to go, skip section 1 and directly go to section 2.

Main sections of setup —

  1. MyEtherWallet setup for new ETH account
  2. KEEP Token Grant
  3. KEEP dashboard contracts
  4. Infura project
  5. Server setup for Random Beacon node

You would need to do all the steps to have the Random Beacon Node running.

1 —Server setup on setup

1.a — After logging into account — you will be taken to the below main page. Click “Deploy Instance”.

1.b — You will be taken to Deploy Instance page. On this page, choose the below setup.

  • For “Choose Server” — Leave the Choose Server to “Cloud Compute”
  • For “Server Location” –Leave the Server Location to Default unless you want to be specific.
  • For “Server Type” — Select the server type to UBUNTU and select 18.04 as below.
  • For “Server Size” — I went with 10$ option. But you can also go with 5$ option to start with.
  • For “Additional Features” — Leave it to default — all unchecked.
  • For “Startup Script” — Not needed
  • For “SSH Keys” — Add public key if you like to login via SSH. For this guide, I will leave it blank i.e. not setup SSH login.
    Note: Vultr auto-generates the root password if you do not setup SSH.
  • For “Server Hostname & Label” — I enter “KEEP-ON-VULTR”, you can enter the desired name.
  • Click Deploy Now.

Give it few mints for the server to be setup.

1.c — Once the Server is deployed — go to “Products”, “Instances” tab as shown below. On Instances, click on “Server Details” as shown.

Copy the “IP address” and “Password”.

That’s the end of section 1.

2 — MyEtherWallet setup for new ETH account

2.a — Create a new Wallet — Accept the defaults and click ‘Next’ few times — then you get to the below page.
2.b — Click “By Keystore File”, enter the password and click “Next”.

2.c — Give it few moments and once the keystore file is ready, download it locally to your computer. Once downloaded, rename it to keep_wallet.json (optional).

2.d — Now get some Ropsten ETH from ETH faucets.

That’s the end of section 2.

3 — KEEP Token Grant

That’s the end of section 3.

4 —KEEP dashboard contracts

4.b — Go-to : and connect the newly imported ETH account from Metamask.
4.c — Delegate the KEEP tokens as below with your ETH address. Accept/Confirm the Metamask Transaction.

4.d — Go to Applications sections and authorize Contracts for tBTC. Note: It takes a while to load this page. Hang on !
Click Authorize and Accept/Confirm the Metamask Transaction — repeat for all. Add some ETH for bonding. Once done, it should look like below.

4.e — Go to Applications sections and authorize Contracts for Random Beacon. Note: It takes a while to load this page. Hang on !
Click Authorize and Accept/Confirm the Metamask Transaction. Once authorized, it should look like below.

That’s the end of section 4.

5 — Infura Project

That’s the end of section 5.

6 — Server setup for Random Beacon node

6.a — Login to your server through putty using the IP address, user name = root and Password generated by VULTR (step 1.c). Or if you used SSH — login to server via SSH.
Note: If you do not have putty already installed, download from here

6.b — One of the first command I always run on new server is

sudo apt-get update

6.c — I recommend changing the default password using the below command (optional).


6.d — Add Firewall rules.

sudo ufw allow 22/tcp
sudo ufw allow 3919/tcp
sudo ufw enable

6.e — Get the Docker for your server using below commands.

sudo apt-get remove docker docker-engine
sudo apt install curl -y
sudo systemctl start docker
sudo systemctl enable docker
sudo docker –version

6.f — Setup directory structure.

mkdir -p $HOME/keep-client/config
mkdir -p $HOME/keep-client/keystore
mkdir -p $HOME/keep-client/persistence

6.g — Export the below environment variables.

export SERVER_IP=$(curl
export INFURA_PROJECT_ID=”<your_infura_project_step_5.b>"
export ETH_WALLET=”<your_ETH_address_step_2.c>”
export KEEP_CLIENT_ETHEREUM_PASSWORD=”<your_ETH_password_step_2.b>

Echo the variables to see if they are correctly set —


6.h — keystore file setup.

nano $HOME/keep-client/keystore/keep_wallet.json

Copy the keep_wallet.json file contents to newly created file on server keep_wallet.json
Save and exit.
To confirm if the file is correct check with cat command,

cat keep-client/keystore/keep_wallet.json

6.i — Config file setup.

nano $HOME/keep-client/config/config.toml

Update Infura End points (step 5.b) and ETH address (step 2.c). Rest of the things, you can copy as-is.

# Ethereum host connection info.
URL = “wss://”
# Keep operator Ethereum account.
Address = “0x436c87808eda3f52cad17f7bcd70e78cd2fa86bd”
KeyFile = “/mnt/keystore/keep_wallet.json”
# Keep contract addresses configuration.
KeepRandomBeaconOperator = “0x9233Fd6C58e37dab223EF1dFD5e33eD69FD1f93b”
TokenStaking = “0x88B3D0Bfb8F207292Dc4Cee7C923d0E7C3078a18”
KeepRandomBeaconService = “0xa5018dbeB6920A04e0CFd3D8F0F45BC851838b0D”
# Keep network configuration.
Peers = [
Port = 3919
# Override the node’s default addresses announced in the network
AnnouncedAddresses = [“/ip4/$SERVER_IP/tcp/3919”]
# Storage is encrypted
DataDir = “/mnt/persistence”

Note: Bootstrap peers keep changing and you might have to check in discord/github to get the latest.

6.j — Start docker using below command.

sudo docker run -dit \
--restart always \
--volume $HOME/keep-client:/mnt \
--env LOG_LEVEL=debug \
--name keep-client \
-p 3919:3919 \
keepnetwork/keep-client:latest --config /mnt/config/config.toml start

Note: Version v1.2.0-rc might get updated and you might have to check in discord/github to get the latest.
If something messed up during setup, you have to stop/remove and then recreate the docker.

6.k — Check if docker is running and check logs.

sudo docker ps -a
sudo docker logs keep-client -f

6.l — Check if you are connected to peers :

sudo docker logs keep-client -f | grep “peers”

If your count is more than 0, you are good and done. You have now successfully deployed your KEEP Random Beacon Node on, Congraultaions !!

If you get stuck with any steps, hop into discord and there are many folks who can help !

Additional resources :

Learner, Crypto !!