This guide will show you how to safely upgrade a Lotus node to a newer version.

Installing an update

Usually, if you are updating Lotus, it as simple as rebuilding and re-installing the software after pulling the latest state for the chosen branch and repository. You can do that with:

git pull
git checkout releases
# 'releases' always checks out the latest stable release
# if you need a specific release use 
# git checkout <tag_or_release>
git submodule update

Once the new version is checked-out, rebuild and re-install as explained in the installation guide.

You can verify your current version with:

lotus --version # for the lotus binary
lotus version   # for the currently running daemon

Cross-check your config file

All upgrades require that you double-check that your configuration files are up-to-date. You can do this by exporting the default configuration files from Lotus and comparing them to your configuration files.

To export the default configuration files from Lotus, run:

lotus config default

This will output something like:

  # Binding address for the Lotus API
  # type: string
  #ListenAddress = "/ip4/"


If you would prefer to have Lotus export the default configuration to a file, run:

lotus config default >> ~/default-lotus-client-configuration.toml

Once you have the default configuration file, compare it with your configuration file and make sure that you’re not missing any sections. See the Lotus release notes for details on what new sections have been added.

Switching networks

If you want to switch networks, use the switching networks guide.

Edit this page on GitHub