"IPFS" Inter Planetary File System & Webui using go-ipfs

Introduction

What I aim to do in this blog is reveal the necessary instructions in English to build and install IPFS on, in this case the Raspberry Pi Ver 3 SBC (Single Board Computer). However if you follow the steps provided being careful to select appropriate Operating System it should work certainly for Linux based computers.

Tools I used

• raspberrypi/downloads I used Raspbian Stretch Lite
  (https://downloads.raspberrypi.org/raspbian_lite_latest)
• etcher available from etcher.io
  (https://github.com/resin-io/etcher/releases/download/v1.2.0/etcher-1.2.0-linux-x86_64.zip)
  download the application appropriate for your system.
• ipfs.io/docs/install select the download appriate to Install Go IPFS on your system I used arm for the RaspberryPi
  (https://dist.ipfs.io/go-ipfs/v0.4.13/go-ipfs_v0.4.13_linux-arm.tar.gz)
  Please use latest build
• Howto Documents (https://ipfs.io/docs/getting-started)
• A Laptop or PC to flash the micro sdcard, and as a client to remotely connect to the Raspberry Pi to download, browse and select, copy as necessary links used to port onto the RPi.

Install the latest rpi-lite_build available from http://raspberrypi.org/downloads to a your micro sdcard I use Etcher it's quick and verifies the flashed sdcard. Then place sdcard in your Raspberry Pi.

I use etcher to install directly the zipped iso to a 8gb sdcard or better

Boot and login as usual as user "pi" with "raspberry" as the password (changing this later)

If you are using a wireless you will need to update your wireless configuration for your wireless access point with a valid password you can only do this step as root, "sudo" does not work, if you are using a ethernet cable you can skip this step.

Important do this first, if you are using wireless network

sudo su
then
wpa_passphrase AccessPointName AccessPointPassword >> /etc/wpa_supplicant/wpa_supplicant.conf

(Both AccessPoint & AccessPointPassword may be case sensitive) Best way is copy character by character including the spaces and special symbols ">>" all of which are necessary.

then test with

apt update && apt upgrade -y && apt install -y vim tmux screen git htop fuse && rpi-update

We have used "double &" to ensure the next command in the chain does not start until proceeding command has finished without error, as user root you do not use sudo (it's not needed) if you do get apt errors restart your wireless network device in the RaspberryPi or reboot as necessary.

then
raspi-config => 5 Interface Options => P2 enable ssh => yes (This is a console menu system only "raspi-config" is a command)

Edit /etc/config.txt in my case i used vim but you can use any you are familiar with

vim /etc/boot/config.txt

add the following at the bottom of the config.txt file on a new line

avoid_warnings=1
(For you reference do not type this line - This gets rid of the lightening bolt on the screen you sometimes seen mainly on Pi-top and Pi-top ceeds)

Reboot and login

Next login to your RPi via ssh using it's ip address in the following format from your Laptop/Pc this allows you to login to your RPi remotely. You can find your network address either from your connected router or typing the following command into your console (The console is your direct connection via HDMi normally not needed unless you don't know the network address for your RPi).

ifconfig

Switch to you Laptop / Pc terminal and using the address obtained -l = login and pi obviously is user pi

ssh aaa.bbb.ccc.ddd -l pi
or
ssh [email protected]
should you prefer this method that's fine they are both exactly the same.

Via a Pc or laptop, as RPi is headless and is a lite build, navigate to ipfs.io/docs/install in your browser

type the url (Uniform Resource Locator)
https://ipfs.io/docs/install

Click the link for

Download IPFS for your platform (Button)

Then right mouse click "arm" along the same row for Linux binary and copy the download link

Select your ssh terminal to the RPi and type and paste the following

type wget then a space then paste what you hold in the clipboard it should look something like this.

wget https://dist.ipfs.io/go-ipfs/v0.4.13/go-ipfs_v0.4.13_linux-arm.tar.gz

this downloads the file then type the command below carefully select correct filename downloaded

tar xvf go-ipfs_v0.4.13_linux-arm.tar.gz

Use the current downloaded file whatever it is mine was go-ipfs_v0.4.13_linux-arm.tar.gz

then
cd go-ipfs

sudo ./install

then type the following

ipfs init

ipfs daemon &

Now the magic bit so pay attention

IPFS has been installed and is now running on you raspberry pi computer, you cannot access the webui at this point as it exist's on a remote computer. So tp get around this from a Laptop or Pc connected to the same network as the RPi we can use this clever little trick.

Open a NEW terminal on your Pc or laptop do this very important this step, this ensure's you not close the daemon already running, and that we setup previously.

ssh -L 5001:localhost:5001 aaa.bbb.ccc.ddd -l pi

If you followed all the above steps you will not need to be root (where a.b.c.d is the address on your network of your RPI)

What this does is to map your laptop/Pc localhost:5001 to aaa.bbb.ccc.ddd:5001 this is why you need to activate openssh-server in raspi-config earlier. So in your own chosen browser, chromium is fine on your laptop/Pc in the URL type localhost:5001/webui only you can access the user webui interface which should be on the same network as the RPi.

type in browser url
localhost:5001/webui

To add a directory return to the RPi terminal and type following for sake of argument

cd ~
mkdir data

copy your files and / or directories into this data folder

then

ipfs add -r data

Sites Referenced

https://ipfs.io/docs/install