The process of storing and retrieving data using the Filecoin network is slightly different from how most storage platforms work. This tutorial walks you through the whole end-to-end process of keeping your data and then getting it back when you need it! We’re going to use Lotus and the command-line in this tutorial.

The process is split into three main parts: the set-up, storing your data and retrieving your data. Each section has several sub-processes that we need to follow.

Set up1. Get access to a Lotus full-node.
2. Start a Lotus lite-node on your local computer.
3. Get a FIL address.
4. Sign up for Filecoin Plus.
Store data1. Package your data.
2. Import your data into Lotus.
3. Find a storage provider through the Filecoin Plus storage provider registry.
4. Create a storage deal.
5. Wait for the deal to complete.
Retrieve data1. Create a retrieval deal.
2. Download your data.

It will take about an hour to complete this tutorial. While there aren’t too many steps involved, there’s a bit of waiting around for the network to process your requests.


If you are using macOS you must have Homebrew installed.

Take notes

There are a few things to remember throughout this tutorial, such as Miner IDs and addresses. There is a table at the end of each section showing the information you should record:

Miner IDThe unique identifier for each storage provider.f01000

The above table is an example of what you will see throughout the tutorial; you don’t have to copy it down.

Terms and phrases

This tutorial contains some words and phrases that you might not be familiar with. Refer back to this table if you encounter something you don’t understand:

AddressA string of letters and numbers that other users can send FIL to.
Block explorerA service, usually a website, that lets you view details of a blockchain such as transactions, deals, and addresses.
DealAn agreement between two computers about what to do with some data.
FILThe shorthand representation of the filecoin cryptocurrency. For example: We charge 0.5 FIL per GiB.
Filecoin (upper-case F)The network that transactions and storage deals take place on. For example: Museums can use the Filecoin network to store their digital archives.
filecoin (lower-case f)The cryptocurrency that the Filecoin network runs on. For example: You can use filecoin to pay for your transactions.
MinerAn alternate name for a storage provider.
Private keyA string of letters and numbers that programs use to interact with the Filecoin network. Keep your private key safe, and don’t share it with anyone.
Storage dealAn agreement between a storage provider and a client about what data to store, how long for, and how much the storage provider can charge for storage.
Retrieval dealAn agreement between a storage provider and a client about how much the storage provider can charge to send data to a client.
Storage clientThe user that wants to store something on the Filecoin network. In this tutorial, you are the storage client.
Storage providerA computer on the Filecoin network offering storage space to other users who want to store data. Storage providers are sometimes called miners.
WalletA collection of addresses. Think of each wallet as a folder and each address as a single file in that folder.

Next steps

Before we can manage data on the Filecoin network, we need to set up things like a Lotus node and a Filecoin wallet. Head to the set-up section to start gathering your resources →