DOT-Files/Gentoo/gentooamd/home/user/.tldrc/tldr/pages/common/ipfs.md

# ipfs

> Inter Planetary File System.
> A peer-to-peer hypermedia protocol. Aims to make the web more open.
> More information: <https://docs.ipfs.tech/reference/kubo/cli/>.

- Add a file from local to the filesystem, pin it and print the relative hash:

`ipfs add {{path/to/file}}`

- Add a directory and its files recursively from local to the filesystem and print the relative hash:

`ipfs add {{[-r|--recursive]}} {{path/to/directory}}`

- Save a remote file and give it a name but not pin it:

`ipfs get {{hash}} {{[-o|--output]}} {{path/to/file}}`

- Pin a remote file locally:

`ipfs pin add {{hash}}`

- Display pinned files:

`ipfs pin ls`

- Unpin a file from the local storage:

`ipfs pin rm {{hash}}`

- Remove unpinned files from local storage:

`ipfs repo gc`