Congratulations, you’ve been approved as a new validator! To get started, you will need to:
- Setup and configure your validation node
- Wait for vote finalization by current validators
- [Optional] Wait for bridge setup (only if being added to bridge, this will typically not be the case)
- Set metadata in the dApp
- [Optional] Bridge validator setup
If you experience any issues during installation, please post your questions in the https://forum.poa.network/c/xdai-chain/validators-support-private.
7.Setup and configure your Validator Node
I. Prerequisites of control machine
+---------------------+ +-------------------------+ | | | | | local host | ansible | remote host | | (control machine) +------------------> (validator node) | | | | | +---------------------+ +-------------------------+
If you know what ssh keys are, skip this section.
- Check if you already have a keypair:
ls -la ~/.ssh
if you get an error that the directory does not exist or the directory is empty, follow the instructions below. If you already have key pair, you can skip the rest of this section.
- Generate new ssh key-pair
ssh-keygen -t rsa -b 4096 -C "firstname.lastname@example.org"
insert your email address and a strong password. By default, keys will be saved to
~/.ssh/ and named
id_rsa with your public key being
Check that you have python 2 version >= 2.6.5 or python 3 version >= 3.3 installed
if not - install it choosing appropriate binary from here
- Check that you have ansible version >= 2.3 installed
if not - follow this guide to install ansible. For example, you can use
pip to do it:
sudo pip install ansible
Check that you have git installed
if not - install it following instructions here
II. Validator Node setup
Node setup is at your discretion - criteria are included in the following instructions.
- Create a node yourself with your favorite hosting provider (e.g. AWS/Azure/OVH/etc). Non-AWS Details
- Use our automated playbooks to create a node on AWS (requires creating an account on AWS). AWS Details
III. Ansible Playbook Configuration
- clone repository with ansible playbooks and checkout branch corresponding to xDai:
git clone https://github.com/poanetwork/deployment-playbooks.git cd deployment-playbooks git checkout dai
- prepare files with ssh keys (replace
id_rsa.pubwith your key name)
cat ~/.ssh/id_rsa.pub > files/admins.pub cp files/admins.pub files/ssh_validator.pub
- create file with configuration settings:
cat group_vars/all.yml.network group_vars/validator.yml.example > group_vars/all.yml
group_vars/all.ymlfile in your favorite text editor, e.g.
Provide the following configuration parameters:
NODE_FULLNAME- enter your organization name (this will be publicly visible)
NODE_ADMIN_EMAIL- enter your public email (this will be publicly visible)
NETSTATS_SERVER- ask one of existing validators (e.g. POA) to provide you with correct url of the netstats server
NETSTATS_SECRET- ask one of existing validators (e.g. POA) to share the netstats secret code with you. Do not share it with non-validators or people outside of xDai network
MINING_KEYFILE- insert content of your mining keystore file here, enclosed in single brackets. The result should look similar to this:
MINING_ADDRESS- insert your mining key address, e.g.
MINING_KEYPASS- insert passphrase from keystore file
nano, to save file and exit, use CTRL+X and then Y
IV. Running ansible playbook
- create a file named
hostsfrom the hosts.example file (again, using
nanoas an example)
cp hosts.example hosts nano hosts
Add only the following content - other fields can be deleted / commented out. (replace 192.0.2.1 with your node’s actual ip address):
[validator] 192.0.2.1 [ubuntu] 192.0.2.1
- run ansible playbook, replace path of
--key-fileargument with your desired SSH key
ansible-playbook -i hosts validator.yml -K --key-file "~/.ssh/id_rsa"
The process should complete successfully. During installation you may be asked to provide sudo password for the user on remote host.
open https://dai-netstat.poa.network and check that your node appears on the list and has >0 peers. Wait until it syncronizes with the rest of the blockchain (block number and block hash should match the rest of the network).
Let the current validators know your node is running.
8. Wait for vote finalization by current validators
The current validators will finalize the vote. After this occurs, they will let you know to proceed.
9. [Optional] Wait for bridge validation setup
Only if you are also being added as a bridge validator. If so, wait for confirmation before proceeding to step 10.
10. Set Metadata
After the approval vote has been finalized by the current validators, you will provide a description of your organization (metadata). To set your metadata for the first time, go to https://validators.poa.network/poa-dapps-validators/set, connect to xDai chain, and select your VOTING key. You should see an interface like this:
Select “I’m a company” and provide the full company name and contact email address. Then click “Update metadata” and sign the transaction.
Once this is complete, open https://blockscout.com/poa/dai and find a block generated by you (your mining key) in the last few blocks. This will be the final confirmation that your node is running and mining blocks. Unless you are also onboarding as a bridge validator, the process is complete.
11. [Optional] Bridge validator setup
If you are also becoming a bridge validator, you can setup your bridge node.
General Process Flow
Newly Elected Validator
|1||Post introduction in forum|
|2||Generate Ethereum accounts|
|3||Fund bridge account|
|4||Announce generated accounts|
|5||Add a validator ballot|
|6||Vote on a candidate ballot|
|7||Install network validator node|
|9||Add new validator to bridge (if applicable)|
|11||Install bridge validator node (if applicable)|