Skip to main content

Use Chaindata Snapshots

You can start a node from an already-synced database called a chaindata snapshot. A chaindata snapshot is a compressed Kaia data directory.

note

This saves time to Full Sync the whole blockchain, allowing you to relatively quickly start a new node or recover from corrupt database.

Prepare Data Directory​

Before start, prepare enough disk space to accommodate both compressed file and uncompressed directory.

  • If you're going to start from an empty machine, simply create a datadir.

    sudo mkdir /var/kend

  • If you're going to swap the existing directory, create a temporary directory.
    • Option 1. Mount a new disk (Recommended for optimal disk utilization)

      $ lsblk
      NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT
      nvme2n1 259:0 0 3500G 0 disk /var/kend2 # New disk at temporary path
      nvme1n1 259:0 0 4000G 0 disk /var/kcnd # Old disk at production path
      nvme0n1 259:2 0 8G 0 disk
      ├─nvme0n1p1 259:3 0 8G 0 part /
      └─nvme0n1p128 259:4 0 1M 0 part

    • Option 2. Use existing disk

      sudo mkdir /var/kend2/data

Download the File​

Download a compressed file to the new directory. URLs can be found at the bottom of this page.

  • Option 1. curl

    curl -O https://s3.ap-northeast-2.amazonaws.com/klaytn-chaindata/mainnet/kaia-mainnet-chaindata-xxxxxxxxxxxxxx.tar.gz

  • Option 2. wget

    wget https://s3.ap-northeast-2.amazonaws.com/klaytn-chaindata/mainnet/kaia-mainnet-chaindata-xxxxxxxxxxxxxx.tar.gz

  • Option 3. axel

    # Amazon Linux installation example
    sudo amazon-linux-extras install epel
    sudo yum install axel pigz
    # Multi-threaded download and print status bar
    axel -n8 https://s3.ap-northeast-2.amazonaws.com/klaytn-chaindata/mainnet/kaia-mainnet-chaindata-xxxxxxxxxxxxxx.tar.gz | awk -W interactive '$0~/\[/{printf "%s'$'\r''", $0}'

Decompress the File​

  • Option 1. tar

    tar -xvf kaia-mainnet-chaindata-xxxxxxxxxxxxxx.tar.gz

  • Option 2. tar and pigz

    # Amazon Linux installation example
    sudo yum install pigz
    # Multi-threaded decompression
    tar -I pigz -xvf kaia-mainnet-chaindata-xxxxxxxxxxxxxx.tar.gz

Swap the data directory​

  • First, stop the node.
    • IMPORTANT: If you are running a consensus node (CN), make sure to remove the node from the Council.
  • Option 1. Swap the content at the same path
    • If you mounted new disk, change the mount.

      umount /var/kend # Old disk
      umount /var/kend2 # New disk at temporary path
      mount /dev/nvme2n1 /var/kend # New disk at production path

    • If you used existing disk, rename the directory.

      mv /var/kend /var/kend_old # Old data
      mv /var/kend2 /var/kend # New data

  • Option 2. Change the path in the node configuraion
    • Change DATA_DIR value in the kend.conf file.
  • Optionally delete old data and tar.gz file.
  • Finally, start the node.

Downloads​

For efficiency, only batch pruned (state migrated) or live pruned database are provided. Read Storage Optimization for their concepts. If you want a full database without neither pruning, or even archive data, perform a fresh full sync from genesis.

networksync optionsdownload
mainnetstate migratedhttps://packages.kaia.io/mainnet/chaindata/
mainnetlive pruninghttps://packages.kaia.io/mainnet/pruning-chaindata/
kairosstate migratedhttps://packages.kaia.io/kairos/chaindata/
kairoslive pruninghttps://packages.kaia.io/kairos/pruning-chaindata/