Branch: master
Find file History
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
status.yml Add status playbook Dec 16, 2017

Ansible Installer

The ansible installer will allow you to configure multiple nodes simultaneously.

If you have an existing node it will be easiest to run the installer from that node.

apt-get install ansible
git clone
cd docker-zen-node/ansible/

Configure the hosts files with your list of nodes, an example hosts file would look like this:

# Parameters passed to all hosts

[zen-nodes] stakeaddr=test nodetype=secure stakeaddr=test nodetype=secure stakeaddr=test nodetype=secure


If you are running this from an existing node, jump down to the bootstrap node section to speed up node installation.

Now run the installer, this will install the securenodes on all of your listed hosts.

ansible-playbook -i hosts main.yml

When the installation completes, all your installed nodes details will be stored in /tmp/zen-node-results

cat /tmp/zen-node-results

It will list results similar to this:


Shield Address:

  transparent: 0.00
  private: 0.00
  total: 0.00

You will now need to send the 1 ZEN to the shield addresses that have a balance of 0.0

Bootstraping the blockchain

Bootstrapping currently does not work.

If you are running the installer on the same server as an existing zen-node, you can bootstrap/seed the initial blockchain to your new nodes so they can sync faster.

Simply add the new nodes to your hosts inventory file as:


Now run the bootstrap playbook:

ansible-playbook -i hosts bootstrap.yml

This will copy the blockchain from your current node (running the installer) to your new nodes. After you run this, remove the nodes from the [bootstrap-nodes] group and run the full installer.


The installer has a handy way to update all of your zen-nodes:

ansible-playbook -i hosts upgrade.yml

This will upgrade restart the required services. It is recommended you subscribe to announcement tracking to receive email notifications.


You may check the status of your nodes anytime with the command:

ansible-playbook -i hosts status.yml

This will report the node name, shield address, balance and current block.