Install

Install IonFS for Windows, Mac and Linux

Windows

Prerequisites

7-Zip or other bzip2-compatible archive tool installed.

If 7-Zip is not installed in your path, i.e. an error is returned when running the 7z command, please enter the following to temporarily add it to your path:

$env:Path += ";C:\Program Files\7-Zip"

Create the following folders within your user's home directory. .ionfs will be used to store the IonFS appsettings.json file used for configuration. $env:localappdata\Ionburst is the directory used to host the IonFS binary.

mkdir ~/.ionfs
mkdir $env:localappdata\Ionburst

Download IonFS

Download the IonFS archive to the created Ionburst directory.

cd $env:localappdata\Ionburst
Invoke-WebRequest https://ionfs.s3.fr-par.scw.cloud/ionfs-0.1.0-windows.tar.bz2 -OutFile ionfs-windows.tar.bz2

Extract archive

Extract the IonFS binary.

cd $env:localappdata\Ionburst
7z x ionfs-windows.tar.bz2 | 7z x ionfs-windows.tar

Complete installation

Move the template appsettings.json to the .ionfs directory.

cd $env:localappdata\Ionburst
mv appsettings.json ~/.ionfs/

Add the ionfs executable path to your $PATH.

setx path "%path%;%localappdata%\Ionburst"

Execute

Execute the IonFS binary to check it has installed correctly.

ionfs

Mac

Prerequisites

bzip2 compatible archive tool installed. By default, bzip2 should be installed.

Download ionfs archive (and sig)

Download the IonFS archive to the current directory. Downloading the file signature is optional.

curl https://ionfs.s3.fr-par.scw.cloud/ionfs-0.1.0-mac.tar.bz2 -o ionfs-mac.tar.bz2
curl https://ionfs.s3.fr-par.scw.cloud/ionfs-0.1.0-mac.tar.bz2.minisig -o ionfs-mac.tar.bz2.minisig

Check signature (optional)

Use minisign to verify the IonFS archive.

minisign -V -P RWQvQIM7Sn+0FvGyZkSAED1dlwc5HZ8c6T5+oPyYoquMoFP+8mNzW7D3 -m ionfs-mac.tar.bz2

Extract archive

Extract the IonFS binary.

tar xvf ionfs-mac.tar.bz2

Complete installation

Create an .ionfs directory within the home directory of your user. Move the appsettings.json file used for configuration to this directory, and move the ionfs binary to a directory within your user's $PATH.

mkdir ~/.ionfs
mv appsettings.json ~/.ionfs
mv ionfs /usr/local/bin

Note, if brew is not installed, then the command to move ionfs may fail. If this occurs, use sudo mv ionfs /usr/local/bin and enter your password when prompted.

Execute the IonFS binary to check it has installed correctly.

ionfs

Linux (Centos/Fedora)

Install Prerequisites

Install the pre-requisite tools.

yum install -y bzip2 libicu

Download ionfs archive (and sig)

Download the IonFS archive to the current directory. Downloading the file signature is optional.

curl https://ionfs.s3.fr-par.scw.cloud/ionfs-0.1.0-linux.tar.bz2 -o ionfs-linux.tar.bz2
curl https://ionfs.s3.fr-par.scw.cloud/ionfs-0.1.0-linux.tar.bz2.minisig -o ionfs-linux.tar.bz2.minisig

Check signature (optional)

Use minisign to verify the IonFS archive.

minisign -V -P RWQvQIM7Sn+0FvGyZkSAED1dlwc5HZ8c6T5+oPyYoquMoFP+8mNzW7D3 -m ionfs-linux.tar.bz2

Extract archive

Extract the IonFS binary.

tar xvf ionfs-linux.tar.bz2

Complete installation

Create an .ionfs directory within the home directory of your user. Move the appsettings.json file used for configuration to this directory, and move the ionfs binary to a directory within your user's $PATH.

mkdir ~/.ionfs
mv appsettings.json ~/.ionfs
sudo mv ionfs /usr/local/bin

Execute

Execute the IonFS binary to check it has installed correctly.

ionfs

Linux (Ubuntu/Debian)

Install Prerequisites

Install the pre-requisite tools.

sudo apt install -y bzip2 libicu66

Download ionfs archive (and sig)

Download the IonFS archive to the current directory. Downloading the file signature is optional.

curl https://ionfs.s3.fr-par.scw.cloud/ionfs-0.1.0-linux.tar.bz2 -o ionfs-linux.tar.bz2
curl https://ionfs.s3.fr-par.scw.cloud/ionfs-0.1.0-linux.tar.bz2.minisig -o ionfs-linux.tar.bz2.minisig

Check signature (optional)

Use minisign to verify the IonFS archive.

minisign -V -P RWQvQIM7Sn+0FvGyZkSAED1dlwc5HZ8c6T5+oPyYoquMoFP+8mNzW7D3 -m ionfs-linux.tar.bz2

Extract archive

Extract the IonFS binary.

tar xvf ionfs-linux.tar.bz2

Complete installation

Create an .ionfs directory within the home directory of your user. Move the appsettings.json file used for configuration to this directory, and move the ionfs binary to a directory within your user's $PATH.

mkdir ~/.ionfs
mv appsettings.json ~/.ionfs
sudo mv ionfs /usr/local/bin

Execute

Execute the IonFS binary to check it has installed correctly.

ionfs