lotus/documentation/en/retrieving-data.md

# Retrieving Data

> There are recent bug reports with these instructions. If you happen to
> encounter any problems, please create a
> [GitHub issue](https://github.com/filecoin-project/lotus/issues/new) and a
> maintainer will address the problem as soon as they can.

Here are the operations you can perform after you have stored and sealed a
**Data CID** with the **Lotus Storage Miner** in the network.

If you would like to learn how to store a **Data CID** on a miner, read the
instructions [here](https://docs.lotu.sh/en+storing-data).

## Find by Data CID

```sh
lotus client find <Data CID>
# LOCAL
# RETRIEVAL <miner>@<miner peerId>-<deal funds>-<size>
```

## Retrieve by Data CID

All fields are required.

```sh
lotus client retrieve <Data CID> <outfile>
```

If the outfile does not exist it will be created in the Lotus repository
directory.

This command will initiate a **retrieval deal** and write the data to your
computer. This process may take 2 to 10 minutes.
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00			`# Retrieving Data`

documentation: adds prettier formatting to markdown files (en) 2019-12-18 18:40:47 +00:00			`> There are recent bug reports with these instructions. If you happen to`
			`> encounter any problems, please create a`
			`> [GitHub issue](https://github.com/filecoin-project/lotus/issues/new) and a`
			`> maintainer will address the problem as soon as they can.`
documentation: current state of public documentation from https://docs.lotu.sh 2019-12-06 15:26:03 +00:00
documentation: adds prettier formatting to markdown files (en) 2019-12-18 18:40:47 +00:00			`Here are the operations you can perform after you have stored and sealed a`
			`Data CID with the Lotus Storage Miner in the network.`
documentation: current state of public documentation from https://docs.lotu.sh 2019-12-06 15:26:03 +00:00
documentation: adds prettier formatting to markdown files (en) 2019-12-18 18:40:47 +00:00			`If you would like to learn how to store a Data CID on a miner, read the`
			`instructions [here](https://docs.lotu.sh/en+storing-data).`
documentation: current state of public documentation from https://docs.lotu.sh 2019-12-06 15:26:03 +00:00
			`## Find by Data CID`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00
			```sh
documentation: current state of public documentation from https://docs.lotu.sh 2019-12-06 15:26:03 +00:00			`lotus client find <Data CID>`
			`# LOCAL`
			`# RETRIEVAL <miner>@<miner peerId>-<deal funds>-<size>`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00			```

documentation: current state of public documentation from https://docs.lotu.sh 2019-12-06 15:26:03 +00:00			`## Retrieve by Data CID`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00
documentation: latest updates from feedback across team 2019-12-09 12:53:40 +00:00			`All fields are required.`

documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00			```sh
documentation: current state of public documentation from https://docs.lotu.sh 2019-12-06 15:26:03 +00:00			`lotus client retrieve <Data CID> <outfile>`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00			```

documentation: adds prettier formatting to markdown files (en) 2019-12-18 18:40:47 +00:00			`If the outfile does not exist it will be created in the Lotus repository`
			`directory.`
documentation: latest updates from feedback across team 2019-12-09 12:53:40 +00:00
documentation: adds prettier formatting to markdown files (en) 2019-12-18 18:40:47 +00:00			`This command will initiate a retrieval deal and write the data to your`
			`computer. This process may take 2 to 10 minutes.`