This guide will show you how to switch between various Filecoin networks with Lotus, depending on your testing or development needs.
As we mentioned in the installation guide, Lotus is compiled to operate on a single network, and the information in the configuration folder corresponds to that network.
- Local devnet - You can run a local devnet
You can choose one of the following methods to switch to a different network.
Clean, rebuild, reinstall
The first method is the simplest. In this approach, you remove all the data related to the network you were running on before and launch a Lotus binary built to run on the new one:
Shut down the Lotus daemon if it is currently running.
~/.lotusfolder, or whatever you set
$LOTUS_PATHto. The default is
Clone the Lotus repository and move into the
git clone https://github.com/filecoin-project/lotus cd lotus
make clean ...to specify which network you want to join:
Network Build command Description Mainnet
make clean all
The production Filecoin network. FIL has real-world value on this network. Calibnet
make clean calibnet
A test network with a minimum sector size of 32 GiB. FIL has no real-world value on this network.
Start the Lotus daemon again and let it sync to the new network:
Run on a different
This process deletes everything from the old network, including wallets. If you are on
mainnet and are switching to
calibnet but you want to keep all your
mainnet data intact for when you switch back, change your
$LOTUS_PATH before running
To change your
Backing up Lotus data
If you wish to backup Lotus data, copy the
$LOTUS_PATH) folder somewhere. This will take quite a while if the Lotus node has synced the whole network.