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 September 30, 2022


Migrate the database to a LevelDB2 database.


As of v21.5.0, new Teku installations use a LevelDB2 database. Previous Teku versions use RocksDB which continue to be supported.


teku migrate-database --config-file=<FILE>
teku migrate-database --config-file=/home/me/me_node/config.yaml

Path to the YAML configuration file. The default is none.

data-base-path, data-path

teku migrate-database --data-base-path=<PATH>
teku migrate-database --data-base-path=/home/me/me_node
data-base-path: "/home/me/me_node"

Path to the Teku data directory. The default directory is OS-dependent:

  • macOS: ~/Library/teku
  • Unix/Linux: $XDG_DATA_HOME/teku if $XDG_DATA_HOME is set; otherwise ~/.local/share/teku
  • Windows: %localappdata%\teku

The default Docker image location is /root/.local/share/teku.


teku migrate-database --data-beacon-path=<PATH>
teku migrate-database --data-beacon-path=/home/me/me_node
data-beacon-path: "/home/me/me_node"

Path to the beacon node data. The default is <data-base-path>/beacon where <data-base-path> is specified using --data-base-path.


teku migrate-database --network=<NETWORK>
teku migrate-database --network=mainnet
network: "mainnet"

Predefined network configuration. Accepts a predefined network name, or file path or URL to a YAML configuration file. See the consensus specification for examples.

The default is mainnet.

Possible values are:

Network Chain Type Description
mainnet Consensus layer Production Main network
minimal Consensus layer Test Used for local testing and development networks
goerli Consensus layer Test Multi-client testnet
gnosis Consensus layer Production Network for the Gnosis chain
sepolia Consensus layer Test Multi-client testnet
Questions or feedback? You can discuss issues and obtain free support on Teku Discord channel.