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


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 chain client 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 [Ethereum 2.0 specification] for examples.

The default is mainnet.

Possible values are:

Network Chain Type Description
mainnet Eth 2.0 Production Main network.
minimal Eth 2.0 Test Used for local testing and development networks.
pyrmont Eth 2.0 Test Multi-client testnet.
prater Eth 2.0 Test Multi-client testnet.
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].