Gnosis Chain is moving to Gnosis EEZ

These guides cover running a node and a validator on Gnosis Chain as it runs today, and stay valid until the fork. At activation the validator set retires and nodes keep only an execution client. See the move to Gnosis EEZ.

Managing an existing validator? Go to Validator withdrawals or Voluntary exit.

Command Line Tool

Select the Operating System and follow the instructions:

danger

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.

tip

Learn more about keys and withdrawal credentials.

Linux, MacOS, Arm64
Windows

Copy the download link for Linux, MacOS or Arm64 package from the ETHstaker Deposit CLI.
Download the Validator Data Generation tool
```
wget [URL_FROM_PREVIOUS_STEP]
```
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).

Download the Windows version of the ETHstaker Deposit CLI from the releases page.
Execute Validator Data Generation tool and follow the instructions. In case of doubts, check the tool documentation
- If you want to generate a new mnemonic:
```
deposit.exe new-mnemonic --folder ../consensus/keystores
```
- If you already have a mnemonic generated:
```
deposit.exe 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.

Gnosis
Chiado

Choose gnosis on the network/chain name.

Choose chiado 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 (ideally 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.

success

For custom setup and more instructions, check the ETHstaker Deposit CLI documentation.