Home

Awesome

ipfs-header-image

Learn IPFS

Learn how to use IPFS to store data on the ultimate decentralised/distributed file system!

In this brief tutorial we will cover Why IPFS is needed, What it is, Who should use it and How to get started! <br />

Note: if you are already familiar with Internet History and IPFS, feel free to skim/skip and go straight to the "How?"

Why?

The Internet was designed to be decentralised network that could survive and continue functioning in the event of a natural or man-made disaster destroying part of the network.

While the Network is distributed and thus resilient to failure, the vast majority of content is still served by centralised servers. The founders/creators of the Interned designed the Network and protocols for routing requests across the network, but they did not create a means of distributing and serving content from multiple nodes.

Over the last 20 years we have seen a "winner takes all" accumulation of power and control on the Internet

Concentration of Power, Filtering and Censorship

From the earliest days of the World Wide Web, content hubs emerged as the default way people found information, created content and communicated online. Several of these hubs still exist in some form today (including AOL, Yahoo and MSN.com) however many others are confined to history (e.g: GeoCities, Lycos, Tripod.com & BBS).

After the "Dotcom Crash of 2001" came the resurgence of the web with "Web 2.0", a new era of web-based applications.

More recently new platforms for creating and sharing content have emerged in "Web 2.0"

Wikipedia Blocked in Turkey!

https://en.wikipedia.org/wiki/Block_of_Wikipedia_in_Turkey

What?

This tutorial will take you through the basics of creating content and publishing it on IPFS, but first we need a bit of background knowledge/recap.

What are Centralised, Decentralised and Distributed Networks ?

In a centralised network there is a central node that controls communication between all nodes. A decentralised network is a series of interconnected hubs. If one hub goes down only the nodes connected to that hub will be affected, the rest of the network will still continue to function. The internet is an example of a decentralised network. It is resilient against failure of several hubs.

centralised-vs-decentralised-vs-distributed-original

If the central node in a centralised network goes offline, all communication is disrupted. In a decentralised network, one "hub" can be offline and the rest of the network can still communicate.

centralised-vs-decentralised-vs-distributed-node-down

A distributed network is the most resilient type or "topology". In a distributed network any single node can completely fail and the remaining nodes will still be able to communicate.

<!-- _Most_ of the time using _centralised_ is not a "_problem_", Wikipedia However our existing infrastructure -->

Who?

People on the bleeding edge who can deal with "changing spec", "breaking changes" or "bugs".

How?

For now, your best "first lesson" is proto.school If you get "stuck" going through the examples, see: https://github.com/nelsonic/learn-ipfs/issues/5#issuecomment-445864393

Installation

To install IPFS you can visit https://docs.ipfs.io/introduction/install/ or you can use one of the following scripts...

Mac

  - curl https://dist.ipfs.io/go-ipfs/v0.4.18/go-ipfs_v0.4.18_darwin-amd64.tar.gz --output go-ipfs.tar.gz
  - tar xvfz go-ipfs.tar.gz
  - cd go-ipfs
  - sudo ./install.sh

Linux

  - curl https://dist.ipfs.io/go-ipfs/v0.4.18/go-ipfs_v0.4.18_linux-386.tar.gz --output go-ipfs.tar.gz
  - tar xvfz go-ipfs.tar.gz
  - cd go-ipfs
  - sudo ./install.sh

This Linux script can be included in your .travis.yml file if you need to IPFS functions in your testing environment.

<br /><br />

Open/Unanswered Questions

Q: How do I DELETE something from IPFS?

My biggest question regarding placing files on a distributed file system which I have no control over is how do I DELETE a file?

Read:

What about "Right to be Forgotten" Law?

When IPFS was first doing the rounds on Hacker News the slogan was "The Permanent Web".

ipfs-permanent-web

This has been de-emphasized on the IPFS home page lately, but is still viewable on early press:

https://motherboard.vice.com/en_us/article/78xgaq/the-interplanetary-file-system-wants-to-create-a-permanent-web

The question is: what if someone posts content onto IPFS that they later want to DELETE ... how is that done?

And if it's not possible to delete content permanently (and reliably), is that at odds with the law? https://en.wikipedia.org/wiki/Right_to_be_forgotten

Q: What Guarantees Permanence/Storage of Files?

At present there is zero guarantee that files uploaded to the IPFS filesystem/network will still be there in a few weeks/months time when you need them. You are relying on the "benevolence" of the people running IPFS nodes on the network to host our data. Which as this forum thread notes is currently not reliable: https://discuss.ipfs.io/t/error-merkledag-not-found-lost-file/3279

FileCoin?

The proposed solution to file storage guarantees is a micro payment system called FileCoin. https://filecoin.io

filecoin

At present Protocol Labs has not started (implementation) work on FileCoin. However the team has written plenty of "foundational" code for the protocols that will be used by File Coin so it's "coming" ... but for now it's very much Vaporware.

If you want to understand how FileCoin is going to work read the "white paper": https://filecoin.io/filecoin.pdf

The analysis Filecoin doesn’t want you to read: https://tokeneconomy.co/the-analysis-filecoin-doesnt-want-you-to-read-e60d5243f17c

Related questions:

For example "DTube" uses IPFS and appears to be a promising distributed alternative to YouTube, but until the reliability of content storage is solved, it won't gain "mainstream" adoption.

dtube-content-disappears

LBRY ("library") https://lbry.io is suggested in the comment ...

libr.io-piracy

Sadly, "LBRY" clearly state on their home page that the software can be used for sharing "Hollywood films" ... so while it might be a good (Non-IPFS) distributed file system, they are basically inviting a copyright infringement lawsuit!

Notes, References & Further Reading

Videos