Skip to content

Latest commit

 

History

History
42 lines (26 loc) · 1.55 KB

run.md

File metadata and controls

42 lines (26 loc) · 1.55 KB
Raw

Running Repo Migrations

This document explains how to run repo migrations for Kubo IPFS implementation.

Note that running migrations is a task automatically performed by the ipfs when starting the ipfs daemon after an upgrade or running the ipfs-update tool, so you would normally not need to run the fs-repo-migrations tool.

The fs-repo-migrations tool comes into play when there is a change in the internal on-disk format ipfs uses to store data. In order to avoid losing data, this tool upgrades old versions of the repo to the new ones.

If you run into any trouble, please feel free to open an issue in this repository.

Step 0. Back up your repo (optional)

The migration tool is safe -- it should not delete any data. If you have important data stored only in your ipfs node, and want to be extra safe, you can back up the whole repo with:

cp -r ~/.ipfs ~/.ipfs.bak

Step 1. Downloading the Migration

  • If you have Go installed: go install github.com/ipfs/fs-repo-migrations@latest
  • Otherwise, download a prebuilt binary from the distributions page

Step 2. Run the Migration

Now, run the migration tool:

# if you installed from Go, the tool is in your global $PATH
fs-repo-migrations

# otherwise, unzip the package, cd into it and run the binary:
./fs-repo-migrations

Step 3. Done! Run Kubo.

If the migration completed without error, then you're done! Try running Kubo:

ipfs daemon