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 24, 2021

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 chain client 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 chain client, 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/v1/debug/beacon/states/ endpoint on the beacon chain client (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/v1/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].