|
| 1 | +--- |
| 2 | +description: >- |
| 3 | + Lotus is your gateway to the Filecoin network. It syncs the chain, manages |
| 4 | + wallets, and is required for Curio to interact with your node. |
| 5 | +--- |
| 6 | + |
| 7 | +# Installing and Running Lotus |
| 8 | + |
| 9 | +<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><a href="https://lotus.filecoin.io/lotus/get-started/what-is-lotus/">Lotus Documentation</a></td><td></td></tr><tr><td><a href="https://filecoinproject.slack.com/archives/CPFTWMY7N">Filecoin Slack - #fil-lotus-help</a></td><td></td></tr></tbody></table> |
| 10 | + |
| 11 | +### Build Lotus Daemon |
| 12 | + |
| 13 | +Clone and check out Lotus: |
| 14 | + |
| 15 | +```sh |
| 16 | +git clone https://github.com/filecoin-project/lotus.git |
| 17 | +cd lotus |
| 18 | +git checkout $(curl -s https://api.github.com/repos/filecoin-project/lotus/releases/latest | jq -r .tag_name) |
| 19 | +``` |
| 20 | + |
| 21 | +#### **Build and Install for Mainnet** |
| 22 | + |
| 23 | +```sh |
| 24 | +make clean lotus |
| 25 | +sudo make install-daemon |
| 26 | +lotus --version |
| 27 | +``` |
| 28 | + |
| 29 | +#### **Build and Install for Calibration** |
| 30 | + |
| 31 | +```sh |
| 32 | +make clean && make GOFLAGS="-tags=calibnet" lotus |
| 33 | +sudo make install-daemon |
| 34 | +lotus --version |
| 35 | +``` |
| 36 | + |
| 37 | +{% hint style="success" %} |
| 38 | +You should see something like: lotus version 1.32.2+mainnet+git.ff88d8269 |
| 39 | +{% endhint %} |
| 40 | + |
| 41 | +*** |
| 42 | + |
| 43 | +### Import a Snapshot and Start the Daemon |
| 44 | + |
| 45 | +Download the Snapshot |
| 46 | + |
| 47 | +#### Mainnet: |
| 48 | + |
| 49 | +```sh |
| 50 | +aria2c -x5 -o snapshot.car.zst https://forest-archive.chainsafe.dev/latest/mainnet/ |
| 51 | +``` |
| 52 | + |
| 53 | +#### Calibration: |
| 54 | + |
| 55 | +```sh |
| 56 | +aria2c -x5 -o snapshot.car.zst https://forest-archive.chainsafe.dev/latest/calibnet/ |
| 57 | +``` |
| 58 | + |
| 59 | +#### Import and Start the Daemon |
| 60 | + |
| 61 | +```sh |
| 62 | +lotus daemon --import-snapshot snapshot.car.zst --remove-existing-chain --halt-after-import |
| 63 | +nohup lotus daemon > ~/lotus.log 2>&1 & |
| 64 | +``` |
| 65 | + |
| 66 | +#### **Monitor Sync Progress** |
| 67 | + |
| 68 | +```sh |
| 69 | +lotus sync wait |
| 70 | +``` |
| 71 | + |
| 72 | +#### To monitor continuously: |
| 73 | + |
| 74 | +```sh |
| 75 | +lotus sync wait --watch |
| 76 | +``` |
| 77 | + |
| 78 | +#### **Monitor Logs** |
| 79 | + |
| 80 | +```sh |
| 81 | +tail -f ~/lotus.log |
| 82 | +``` |
| 83 | + |
| 84 | +*** |
| 85 | + |
| 86 | +### Create Wallets |
| 87 | + |
| 88 | +You’ll need to create **two BLS wallets**: |
| 89 | + |
| 90 | +* One for **owner**: used to fund sector pledges and submit proofs |
| 91 | +* One for **worker**: used to publish and manage storage deals |
| 92 | + |
| 93 | +```sh |
| 94 | +lotus wallet new bls # Create owner wallet |
| 95 | +lotus wallet new bls # Create worker wallet |
| 96 | +lotus wallet list # List all created wallets |
| 97 | +``` |
| 98 | + |
| 99 | +Make sure to send a small amount of FIL to each wallet - we recommend 1 FIL per wallet to ensure the creation of your Storage Provider in Curio. |
| 100 | + |
| 101 | +{% hint style="info" %} |
| 102 | +Both wallets will be used during Curio initialisation. |
| 103 | +{% endhint %} |
| 104 | + |
| 105 | +{% hint style="danger" %} |
| 106 | +[Back up](https://lotus.filecoin.io/lotus/manage/manage-fil/#exporting-and-importing-addresses) your wallet keys securely before continuing. Losing them will result in permanent loss of access to funds. |
| 107 | +{% endhint %} |
0 commit comments