Skip to content
IPFS installer for the Raspberry Pi and other ARM-based devices.
Shell Smarty
Branch: master
Clone or download
Nudin and claudiobizzotto Various improvements (#12)
* Install newest version by default
* Allow version to be specified with and without 'v'
* Code clean up
* Make output less verbose
* Add update functionality
* Unify user prompts
Latest commit b86edee Feb 4, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.


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


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:



  • 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}


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



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
You can’t perform that action at this time.