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 May 17, 2022

Start Teku from a recent state

To get Teku up and running in only a few minutes, you can start Teku from a recent finalized checkpoint state rather than syncing from genesis.

When starting from a recent checkpoint, Teku downloads historic chain data in the background.


You need access to a beacon node with REST API enabled (for example, Teku) to download the finalized checkpoint state file.

The following command downloads a recent finalized checkpoint state from a beacon node, and starts Teku:

teku --eth1-endpoint=http://localhost:8545 \
--validator-keys=/Users/me/mainnet/validator/keys:/Users/me/mainnet/validator/passwords \

The command uses the --initial-state option to download the finalized checkpoint state from the /eth/v2/debug/beacon/states/ endpoint on the beacon node (for example, Teku).


You can also download a finalized checkpoint state file, and specify the location using the --initial-state option. To download the file and name it state.ssz run:

curl -o state.ssz -H 'Accept: application/octet-stream' http://other-node:5051/eth/v2/debug/beacon/states/finalized
Infura provides initial state endpoints for free. Registration to Infura services is required. Watch the “Teku Snapshot Sync from Infura” video for more details.

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