diff --git a/content/en/curriculum/ipfs/desktop-tutorial/dekstop3.png b/content/en/curriculum/ipfs/desktop-tutorial/dekstop3.png new file mode 100644 index 00000000..42cc6021 Binary files /dev/null and b/content/en/curriculum/ipfs/desktop-tutorial/dekstop3.png differ diff --git a/content/en/curriculum/ipfs/desktop-tutorial/desktop1.png b/content/en/curriculum/ipfs/desktop-tutorial/desktop1.png new file mode 100644 index 00000000..b179a8bd Binary files /dev/null and b/content/en/curriculum/ipfs/desktop-tutorial/desktop1.png differ diff --git a/content/en/curriculum/ipfs/desktop-tutorial/desktop10.png b/content/en/curriculum/ipfs/desktop-tutorial/desktop10.png new file mode 100644 index 00000000..23dc49e7 Binary files /dev/null and b/content/en/curriculum/ipfs/desktop-tutorial/desktop10.png differ diff --git a/content/en/curriculum/ipfs/desktop-tutorial/desktop2.png b/content/en/curriculum/ipfs/desktop-tutorial/desktop2.png new file mode 100644 index 00000000..5111adf2 Binary files /dev/null and b/content/en/curriculum/ipfs/desktop-tutorial/desktop2.png differ diff --git a/content/en/curriculum/ipfs/desktop-tutorial/desktop4.png b/content/en/curriculum/ipfs/desktop-tutorial/desktop4.png new file mode 100644 index 00000000..d9013fe7 Binary files /dev/null and b/content/en/curriculum/ipfs/desktop-tutorial/desktop4.png differ diff --git a/content/en/curriculum/ipfs/desktop-tutorial/desktop5.png b/content/en/curriculum/ipfs/desktop-tutorial/desktop5.png new file mode 100644 index 00000000..c7d396f4 Binary files /dev/null and b/content/en/curriculum/ipfs/desktop-tutorial/desktop5.png differ diff --git a/content/en/curriculum/ipfs/desktop-tutorial/desktop6.png b/content/en/curriculum/ipfs/desktop-tutorial/desktop6.png new file mode 100644 index 00000000..fb0b9602 Binary files /dev/null and b/content/en/curriculum/ipfs/desktop-tutorial/desktop6.png differ diff --git a/content/en/curriculum/ipfs/desktop-tutorial/desktop7.png b/content/en/curriculum/ipfs/desktop-tutorial/desktop7.png new file mode 100644 index 00000000..2c278bae Binary files /dev/null and b/content/en/curriculum/ipfs/desktop-tutorial/desktop7.png differ diff --git a/content/en/curriculum/ipfs/desktop-tutorial/desktop8.png b/content/en/curriculum/ipfs/desktop-tutorial/desktop8.png new file mode 100644 index 00000000..9fdd58ee Binary files /dev/null and b/content/en/curriculum/ipfs/desktop-tutorial/desktop8.png differ diff --git a/content/en/curriculum/ipfs/desktop-tutorial/desktop9.png b/content/en/curriculum/ipfs/desktop-tutorial/desktop9.png new file mode 100644 index 00000000..58776883 Binary files /dev/null and b/content/en/curriculum/ipfs/desktop-tutorial/desktop9.png differ diff --git a/content/en/curriculum/ipfs/desktop-tutorial/index.md b/content/en/curriculum/ipfs/desktop-tutorial/index.md new file mode 100644 index 00000000..6ddab278 --- /dev/null +++ b/content/en/curriculum/ipfs/desktop-tutorial/index.md @@ -0,0 +1,133 @@ +--- +title: "IPFS Desktop (Tutorial)" +description: "Shallow Dive Tutorial – Using the Graphical Interface for IPFS" +draft: false +menu: + curriculum: + parent: "curriculum-ipfs" +weight: 75 +category: tutorial +level: +- shallow +--- + +## Background +In this tutorial, you will get an introduction of IPFS Desktop, the graphical interface that you can use to interact with the files, folders, IPNS, pinning services, and more. + +![The IPFS Desktop](desktop1.png) + +## Prerequisites +In this tutorial, you will need to have installed (or updated) IPFS Desktop +* [Install IPFS Desktop](https://docs.ipfs.tech/install/ipfs-desktop/) +* Kill any other nodes you may have started in the CLI with `killall ipfs` +* Start IPFS Desktop on your computers + +### Video: IPFS Desktop Walkthrough +{{< youtube bHJGMPJcu_U >}} + +## Instructions +Explore the best workflows and capabilities with IPFS Desktop + +#### Install IPFS Desktop +If you haven't already, follow the [comprehensive tutorial at at docs.ipfs.tech on installing IPFS Desktop](https://docs.ipfs.tech/install/ipfs-desktop/) onto your computer + +#### The Status Page + +The status is the top screen in the menu for IPFS desktop where you can see the basic information about your IPFS node. + +![IPFS Desktop Status Page](desktop1.png) + +On this page: + +* Check and see how much data you have stored on IPFS +* See how many peers you are connected to on IPFS +* Check to see what your PeerID is +* See which kubo version you are running + +#### The Files Page +On this page, you can see all files and directories that are pinned to your ipfs node, either from uploading, or those that are pinned from peers on IPFS. + +* Try out the **+ Import** button to add a file or folder from your local (computer's) storage +* Now, try pinning a file from IPFS. use the **+ Import** button and put in the CID `QmbWqxBEKC3P8tqsKc98xmWNzrzDtRLMiMPL8wBuTGsMnR` + +![IPFS Desktop Import a CID](desktop2.png) + +* Next, click the three dots to the left of the new CID that you just uploaded, click on the 'share link' and share it with your friend (or copy-paste it into the address bar of your own browser window) + +![Share an IPFS File](desktop3.png) + +#### The Explore Page +With this page, you can select an IPFS file or directory, and explore how this files is broken down into UnixFS files. +* Take a look at the CID, and the multihash +* Pick a file, and check out its size, and the number of links to that file + + +![Explore and IPFS File](desktop4.png) + +#### The Peers Page +The peers are the nodes in the IPFS network that you are connected to directly for sharing content. On the peers page: +* Identify how many peers you are connected to +* Notice the location, the types of connections you have. + +> Activity: Identify your IPFS address, and connect with a friend + +* From the **Status** page click on the **Advanced** dropdown, and copy one of your addresses. + +![Get your address](desktop5.png) + +* Send your address to a friend. from the _Peers_ page, click the **+Add connection** button, and enter your friends address to connect as peers. + +![Get your address](desktop6.png) + +#### The Settings Page +There are several useful tools under the settings page of IPFS desktop. Here, you can change the _Gateway_ you use. A _Gateway_ allows you to access IPFS content-addressed content using the typical HTTP addressing that web2 applications use. With a gateway, you can access content on IPFS from your web browser. + +There are many gateways available to use, and you can choose a new one. +* Go to the list of IPFS gateways at the Public Gateway Checker found at [https://ipfs.github.io/public-gateway-checker/](https://ipfs.github.io/public-gateway-checker/) +* Choose one of the gateways and copy it. +* In the form box, type in `https://` then paste the public gateway that you copied from the Public Gateway Checker. + +![Use a Different Gateway](desktop7.png) + +You are now using a different gateway to access the same IPFS public network! All of the same pinned data is available, you are just entering IPFS from a different entry point. + +#### Publishing to IPNS with IPFS Desktop +With IPFS, when you publish a new piece of content, it has a new CID, meaning the data is immutable. This is great when you want to identify a certain piece of data, and make sure you know what you are accessing. There is, however, a use case for mutable data, such as a website. + +You want to give people one address where they can access, say, a website, but want to be able to make updates to it, such as adding an event page, or updating a typo. This is where IPNS comes in. + +IPNS allows you to tie an address in IPFS with the 'latest' piece of data. + +To try this out, do the following steps +* In the **Settings** page, under _IPNS Publishing Keys_, click the **+ Generate Key** button, and choose a name for the key. + +![IPNS Key](desktop8.png) + +* Create or add a folder on the _Files_ page and add at least one file. +* Choose one file, and click on the three buttons on the left side of it, then choose **Publish to IPNS**, and select the key you just created to publish with. + +![Publish to IPNS(desktop9.png) + +* Once it is published, you can share this IPNS address with your neighbor by copy-pasting it + +![Copy IPNS Address](desktop10.png) + + +* Share the IPNS address you copy-pasted with a neighbor and see if they can retrieve it! + +Now, if you were to upload a modified file with the same name to IPFS desktop, you friend could access the new, fresh, updated version of that image with the same IPNS address. + +#### Using Pinning Services with IPFS Desktop +When you add files and folders to IPFS, typically they are only available for retrieval from others when your own node is up and running, unless someone else just happens to pin your file on their node from the network. + +Pinning services provide the service of pinning and maintaining the availability of files on IPFS for you, even when your own node isn't running. + +You can sign up with one of the pinning services, and once you have, you an add the API key that is provided when you signed up to make your files permanently available on IPFS. + + + +### Summary +Congratulations! You have officially used IPFS to pin files, share with your friends, and even used IPNS to create mutable content in web3, you are now ready to start storing and sharing on the distributed web!