Skip to content

claudiobizzotto/ipfs-rpi

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

IPFS RPi (ABANDONED -- DON'T USE)

IMPORTANT: IPFS has its own SystemD files now. Use them instead. https://github.com/ipfs/kubo/tree/master/misc/systemd

A bare bones IPFS installer for the Raspberry Pi and other ARM-based devices.

Installation

Log into your system with an administrator account, like the default OS user. For example, on the Raspberry Pi, most operating systems will default to the pi user, whereas on the Orange Pi that's going to be orangepi.

From any local directory, clone or download this repo, cd into it and run the installer:

./install

Notes

  • Do not execute the installation script with sudo
  • You'll need root privileges to run the installer. The default OS user (pi, orangepi etc.) does so by default
  • The IPFS user directory will be created at ~/.ipfs (eg.: /home/pi/.ipfs, /home/orangepi/.ipfs etc.)

Installation options

You can specify a version for IPFS (eg.: v0.4.11):

./install v0.4.11

IPFS usage

You can find a lot of information on how to use IPFS on the official website. If you just want to test whether the installation was successful or not, you can list your node's peers:

ipfs swarm peers

IPFS daemon

The IPFS daemon needs to be running in order for your IPFS node to appear online. The installer already takes care of running the daemon on system startup by default, but if you want to control that process manually, you can use the operating system's init system directly.

For systemd (Raspbian Stretch, Ubuntu 15.04 and newer, CentOS 7 and newer), you can use:

sudo systemctl {start|status|stop} ipfs-daemon.service

For upstart (Ubuntu 9.10 to Ubuntu 14.10, Centos 6), you can use:

sudo service ipfs-daemon {start|status|stop}

Uninstallation

In order to uninstall IPFS, just execute the uninstaller and follow the uninstallation steps:

./uninstall

Upgrade

If you want to upgrade to a newer version, run the installer again.

Support matrix

SBC/ARM device Raspbian Stretch Ubuntu 14.04
Raspberry Pi 0 Not tested Not tested
Raspberry Pi 1 Yes Not tested
Raspberry Pi 2 Yes Not tested
Raspberry Pi 3 Yes Not tested
Orange Pi Not tested Yes

How to contribute

  • for bug reports, open a new issue
  • for code patches, open a pull request against the development branch
  • for bugs specific to IPFS, please refer to the official channel