migrate-database

Migrate the database to a RocksDB database.

note

As of v26.2.0, new Teku installations use a RocksDB database. Previous Teku versions use LevelDB which has been deprecated and may be removed in a future release.

caution

Before running the database migration, you must shut down the local Teku instance and confirm the process has fully exited and won't be restarted.

config-file

Syntax

teku migrate-database --config-file=<FILE>

Example

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

Environment variable

TEKU_CONFIG_FILE=/home/me/me_node/config.yaml

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

data-base-path, data-path

Syntax

teku migrate-database --data-base-path=<PATH>

Example

teku migrate-database --data-base-path=/home/me/me_node

Environment variable

TEKU_DATA_BASE_PATH=/home/me/me_node

Configuration file

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.

data-beacon-path

Syntax

teku migrate-database --data-beacon-path=<PATH>

Example

teku migrate-database --data-beacon-path=/home/me/me_node

Environment variable

TEKU_DATA_BEACON_PATH=/home/me/me_node

Configuration file

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.

network

Syntax

teku migrate-database --network=<NETWORK>

Example

teku migrate-database --network=mainnet

Environment variable

TEKU_NETWORK=mainnet

Configuration file

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
holesky	Consensus layer	Test	Multi-client testnet
hoodi	Consensus layer	Test	Multi-client testnet
ephemery	Consensus layer	Test	Multi-client testnet
sepolia	Consensus layer	Test	Multi-client testnet
minimal	Consensus layer	Test	Used for local testing and development networks
gnosis	Consensus layer	Production	Network for the Gnosis chain
chiado	Consensus layer	Test	Gnosis testnet
lukso	Consensus layer	Production	Network for the Lukso chain