Skip to content
You are reading the Teku development version documentation and some features may not be available in the stable release. You can switch to the stable version using the version box at the bottom of the screen.

Updated on December 6, 2020

Voluntarily exit a validator

A voluntary exit is when a validator chooses to stop performing its duties, and exits the beacon chain.

To voluntarily exit, the validator must continue performing its validator duties until successfully exited to avoid penalties.


Even if a validator has successfully exited, you cannot withdraw your funds until withdrawals are enabled in a future phase of the Ethereum 2.0 network.

Initiate a voluntary exit

Use the voluntary-exit subcommand to initiate a voluntary exit for specified validators.


teku voluntary-exit --beacon-node-api-endpoint= \
--validator-keys=validator/keys/validator_888eef.json:validator/passwords/validator_888eef.txt \

In the command:

  • Specify the location of the beacon node using --beacon-node-api-endpoint. You must have a running beacon node which has the REST API enabled.
  • Specify the validators to exit using the --validator-keys option.
  • Specify the earliest epoch at which to exit using the --epoch option. If not specified, this defaults to the current epoch. You cannot specify a future epoch.

If using an external signer such as Web3Signer, then specify the external signer URL and public key of the exiting validator:


teku voluntary-exit --beacon-node-api-endpoint= \
--validators-external-signer-public-keys=888eef... \
--validators-external-signer-url=http://localhost:9000 \

Use the /eth/v1/beacon/pool/voluntary_exits API to check the pending exit queue.

Questions or feedback? You can discuss issues and obtain free support on Teku Discord channel.
For paid professional support by Consensys, contact us at