Launch validator instance / validator(s)
Validators are defined by validator keys. Based on the network you are going to stake on, check Gnosis validator keys / Ethereum validator keys generation guide.
-
Do you want to create a new validation instance or extend exisiting instance for more validators?
Create a directory for validator instance data
sudo mkdir -p /var/lib/lodestar/vi1Enable accessing
/var/lib/lodestar/vi1for server usermyserverusersudo chown -R myserveruser:myserveruser /var/lib/lodestar/vi1Load keystores to
:/var/lib/lodestar/vi1Move to Lodestar client directory
cd /usr/local/bin/lodestar./lodestar validator import --network mainnet --importKeystores $HOME/keystores/ddk_i1 --dataDir /var/lib/lodestar/vi1./lodestar validator import --network gnosis --importKeystores $HOME/keystores/ddk_i1 --dataDir /var/lib/lodestar/vi1- Insert keystores encryption password (the one used during keystores generation) on request
- If there are keystores with different encryption password, repeat the process for each encryption password
Create a service user for the validator instance
sudo useradd --system --no-create-home --shell /bin/false lodestar-vi1Set ownership of
/var/lib/lodestar/vi1tolodestar-vi1usersudo chown -R lodestar-vi1:lodestar-vi1 /var/lib/lodestar/vi1Enable access to
:NodeJsfor userlodestar-vi1sudo usermod -aG nodejsusr lodestar-vi1Create configuration service file for
lodestar-vi1service-
Open the configuration file
sudo nano /etc/systemd/system/lodestar-vi1.service -
Copy the configuration below into the file.
:
This can be get with commandnode -v
[Unit] Description=Lodestar Validator Instance (Ethereum Mainnet) Wants=network-online.target After=network-online.target [Service] User=lodestar-vi1 Group=lodestar-vi1 Type=simple Restart=always RestartSec=5 WorkingDirectory=/usr/local/bin/lodestar Environment="PATH=/home/nodejsusr/.nvm/versions/node/v22.16.0/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin" ExecStart=/usr/local/bin/lodestar/lodestar validator \ --network mainnet \ --dataDir /var/lib/lodestar/validators/i1 \ --force \ --beaconNodes http://127.0.0.1:9596 \ --suggestedFeeRecipient 0xXXXXXXXXXXXXXXXX \ --graffiti "Nethermind+Lodestar" [Install] WantedBy=multi-user.targetNotes
[Unit] Description=Lodestar Validator Instance (Gnosis Network) Wants=network-online.target After=network-online.target [Service] User=lodestar-vi1 Group=lodestar-vi1 Type=simple Restart=always RestartSec=5 WorkingDirectory=/usr/local/bin/lodestar Environment="PATH=/home/nodejsusr/.nvm/versions/node/v22.16.0/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin" ExecStart=/usr/local/bin/lodestar/lodestar validator \ --network gnosis \ --dataDir /var/lib/lodestar/validators/i1 \ --suggestedFeeRecipient 0xXXXXXXXXXXXXXXXX \ --beaconNodes http://127.0.0.1:9596 \ --force \ --graffiti "Nethermind+Lodestar" [Install] WantedBy=multi-user.targetNotes
-
Press
CTRL+XthenYthenENTERto save and exit the config file.
-
Adding validator instance to staking services manager
If you use a staking manager client, add the new instance into it.
Stop running validator instance
lodestar-vi1sudo systemctl stop lodestar-vi1Extend
/var/lib/lodestar/validators/i1for new keystores./lodestar validator import --network mainnet --importKeystores $HOME/keystores/ddk_i1 --dataDir /var/lib/lodestar/vi1./lodestar validator import --network gnosis --importKeystores $HOME/keystores/ddk_i1 --dataDir /var/lib/lodestar/vi1- You will be requested to insert keystores encryption password (the one used during keystores generation)
- If there are keystores with different encryption password, repeat the process for each encryption password
- Already existing keystores in the directory will be skipped
Load processed changes to the system
sudo systemctl daemon-reloadStart the validator instance
sudo systemctl start lodestar-vi1Check the running validator instance
systemctl status lodestar-vi1journalctl -fu lodestar-vi1-
Other configurations
Activate service to start automatically on OS startup
sudo systemctl enable lodestar-vi1- Open Delayed Start shell
sudo nano /usr/local/bin/delayed-start.shConfigurate service start inside it
systemctl start lodestar-vi1.service - Be sure,
delayed-start.serviceservice controllingdelayed-start.shis enabled for auto start with system startupsudo systemctl enable delayed-start.service
Configurate Staking Manager util
- Open the configuration file
sudo nano /usr/local/etc/staking/config/clients.confIf the file is empty, generate it with command
sudo /usr/local/bin/staking.sh init - Set link to proper service. It should be as follow:
validatorServices="lodestar-vi1"If you place more services to the category, separate them with a space, see
validatorServices="service1 service2 service3 ..."
- Open the configuration file
-
Activate service to start automatically on OS startup
- Open Start with delay util
sudo nano /usr/local/bin/delayed-start.sh - Place or uncomment a command to start the validator client(s)
/usr/local/bin/staking.sh start validators - Verify, that a service `
delayed-start.service` exists and is automatically launched on system start.sudo systemctl enable delayed-start.service
- Open Start with delay util
Configurate Lodestar validator Log monitor service
Log monitor service monitors the service log and process defined action (fixes) in a case of any issue detected.
- Check, whether the logmonitor util is installed:
/usr/local/bin/logmonitor.sh versionIf the util is not installed, install Lodestar validator Log monitor from GitHub.
- Check defined Errors list for lodestarvalidator service
sudo nano /usr/local/etc/lodestarvalidator_tracking_records.txtIf not available, download it from GitHub. You can also modifiy it, if needed.
- Configurate the validator log monitor for service
lodestar-vi1, see guide on Github. - Place validator logmonitor service into
/usr/local/bin/delayed-start.shutil to start it automatically on system startup- Open
delayed-start.shsudo nano /usr/local/bin/delayed-start.sh - Place validator logmonitor service into the file
systemctl start lodestar-vi1_logmonitor
- Open
- Open Delayed Start shell