> For the complete documentation index, see [llms.txt](https://memolabs.gitbook.io/memo/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://memolabs.gitbook.io/memo/start-usage/start-user-in-docker/how-to-use/upload-and-download.md).

# Upload and Download

## Upload file

Command description: Entering putObject to upload an object named ObjectName into BucketName; if the bucket does not exist, it will display that the bucket does not exist; if the object already exists, it will display that the object already exists.

```
echo "hello MEMO" >~/test.file
mefs-user lfs putObject --bn=test2 --on=obj1 --path=~/test.file
```

```shell
{"level":"DEBUG","time":"2022-03-23T15:20:32+08:00","logger":"httpio","caller":"httpio/reader.go:51","msg":"push stream: /rpc/streams/v0/push/fce925c8-7d24-4cf7-9d3f-0a370fa69d85"}
Put object:
Name: obj1
Bucket ID: 2
Object ID: 0
ETag: b1946ac92492d2347c6235b4d2611184
Size: 6 B
UsedBytes: 2.18 MiB
Enc Method: aes
State: total 9, dispatch 0, done 0, confirm 0
Creation Time: 2022-03-23 15:20:32 CST
Modify Time: 2022-03-23 15:20:32 CST
```

### Check file information

Command description: Enter listObjects to list all objects in BucketName, including object size, creation time, MD5 value, and the most recent challenge time.

```
mefs-user lfs listObjects --bn=test2
```

```shell
List objects:

Name: obj1
Bucket ID: 2
Object ID: 0
ETag: b1946ac92492d2347c6235b4d2611184
Size: 6 B
UsedBytes: 2.18 MiB
Enc Method: aes
State: total 9, dispatch 2, done 2, confirm 0
Creation Time: 2022-03-23 15:20:32 CST
Modify Time: 2022-03-23 15:20:32 CST
```

## Download file

Command description: Enter getObject to download an object named ObjectName from BucketName; if the bucket does not exist, it displays that the bucket does not exist; if the object does not exist, it displays that the object does not exist.

```
mefs-user lfs getObject --bn=test2 --on=obj1 --path=~/test.txt
```

```shell
download: 100% [=======================================================================================================================] ( 6/ 6B, 0.302 kB/s)
object: obj1 (etag: b1946ac92492d2347c6235b4d2611184) is stored in: /home/mtest/test.txt
```