Skip to main content

Command Line Tool

Select the Operating System and follow the instructions:


We highly recommend generating keystores on a safe, completely offline device.

Securely backup your mnemonic, keystores, and password and keep them in a safe place.


Learn more about keys and withdrawal credentials.

  • Copy the download link for Linux, MacOS or Arm64 package from the validator data generation tool.

  • Download the Validator Data Generation tool

  • Unzip the downloaded file

    tar -xvf [FILE_NAME]
  • Get into the folder

    cd deposit-cli-...
  • Execute Validator Data Generation tool and follow the instructions. In case of doubts, check the tool documentation.

    Tip: add the --eth1_withdrawal_address flag when creating your keys, pointing to an address you control.

    • If you want to generate a new mnemonic:
      ./deposit new-mnemonic --folder ../consensus/keystores
    • If you already have a mnemonic generated:
      ./deposit existing-mnemonic --folder ../consensus/keystores
      You will be asked for a mnemonic and index (key number).
  • Select the language of the UI and mnemonic.

  • Choose the number of validators. Remember: 1 GNO = 1 validator. You can run many validators in the same machine.

    Choose gnosis on the network/chain name.
  • Create a password to encrypt the keys.

  • The mnemonic (seed phrase) will show on screen. Save it in a secure place (idealy offline).

  • Type your mnemonic to confirm in the tool.

  • Wait until the keys are created. Two types of files will be generated:

    • deposit_data-*.json
    • One keystore-*.json per validator
  • Save the location of the generated keys, and copy them in a backup USB memory or any other secure storage.


For custom setup and more instructions, check the Validator Data Generation tool documentation.