Repository files navigation

Ansible scripts to deploy up to two Docker based polkadot validator nodes. No need for compiling and complicated dependency management :)

• Polkadot:12Dw4SzhsxX3fpDiLUYXm9oGbfxcbg1Peq67gc5jkkEo1TKr (🍁 HIGH/STAKE 🥩/HEL1 - 2.69% commission)
• Polkadot:12bget8jJWnyjqYPiCwkXZjDh5tDBkta1WUcDYyndbXVDmQ1 (🍁 HIGH/STAKE 🥩/ZRH1 - 0.69% commission)
• Kusama:DbRgw96nMQcFEFZWTLd6LSPNdh8u3NBuUDfAhDmB6UU8cJC (🍁 HIGH/STAKE 🥩/HEL1 - 4.20% commission)
• Kusama:HQuPha82sRy91zZn73XRGJVV3ernBh5HZKftUcoDT8CSUwK (🍁 HIGH/STAKE 🥩/ZRH1 - 10% commission)

Prerequisits:

• VPS or dedicated server meeting the Polkadot/Kusama requirements (you might want to have a beefier machine as we're going to run two validators on one machine)
• ansible (2.11.6+)
• ansible-playbook (2.11.6+)

First copy thehosts.ini-sample tohosts.ini then:

1. Rename the twomy_node_* entries to a name you like, also replace the<IP of your server> with the actual IP of your server
2. Copy/Renamehost_vars/my_node_*.yml files to the same name you just called the host in thehosts.ini file.
3. Update the values in thehost_vars/my_node_*.yml files, you always want to:
4. Update thenode_name this is the node name your validator will show up with in the Telemetry dashboards
5. Update thepolkadot_db_snapshot_url andpolkadot_db_snapshot_checksum with the latest values fromhttps://polkashots.io/
6. Update yourstash_addr with your stash address. (If you don't know what a stash address is you probably don't want to run your own validator!)
7. Place an exportedwallet.json andpassword file inroles/polkadot-claimer/files adding a -kusama or -polkadot suffix to the file name.

If you feel adventerous you can deploy the whole server using:

$ ansible-playbook -i hosts.ini all.yml

This will execute the following roles:

• polkadot-setup
  • Setup Docker
  • Setup Journald
  • Setup motd (message of the day)
• polkadot-restore-db
  • Downloads the in the host_vars defined snapshot and unpacks it to the futuredb_path
• polkadot-validator
  • Starts the polkadot/kusama validators as docker containers
• polkadot-claimer
  • Copies the wallet.json & password files to the server
  • Setups a cronjob which executes a docker container that claims the staking rewards
• polkadot-rotate-keys
  • Rotates the session keys so you can use for theSetSessionKeys extrinsic
• watchtower (not run automatically, run usingansible-playbook -i hosts.ini setup_watchtower.yml)
  • Sets up a watchtower container which monitors upstream container image repositories for new releases and upgrades automatically.

You can also run the individual roles using thesetup_*.yml playbooks instead ofall.yml.

To upgrade to the latest Polkadot version you can simply restart the containers using thepolkadot-validator playbook.

Monitoring is not yet covered in these ansible playbooks. Do NOT run a Polkadot/Kusama validator w/o proper monitoring or you will get slashed.

You should not useroot user on the server, instead replace theansible_user field inhosts.ini with an unpriviledged user (which has docker rights).