Skip to main content

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-latest-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-latest-mac.tar.bz2 -o ionfs-mac.tar.bz2
curl https://ionfs.s3.fr-par.scw.cloud/ionfs-latest-mac.tar.bz2.minisig -o ionfs-mac.tar.bz2.minisig

Check signature (optional)#

Use minisign to verify the IonFS archive.

minisign -V -P RWRa+41p7nG6AdUKsqvHT2sdhL/MaciWB5TcG7qTvqSDCNDlRC19CsZ4 -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-latest-linux.tar.bz2 -o ionfs-linux.tar.bz2
curl https://ionfs.s3.fr-par.scw.cloud/ionfs-latest-linux.tar.bz2.minisig -o ionfs-linux.tar.bz2.minisig

Check signature (optional)#

Use minisign to verify the IonFS archive.

minisign -V -P RWRa+41p7nG6AdUKsqvHT2sdhL/MaciWB5TcG7qTvqSDCNDlRC19CsZ4 -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-latest-linux.tar.bz2 -o ionfs-linux.tar.bz2
curl https://ionfs.s3.fr-par.scw.cloud/ionfs-latest-linux.tar.bz2.minisig -o ionfs-linux.tar.bz2.minisig

Check signature (optional)#

Use minisign to verify the IonFS archive.

minisign -V -P RWRa+41p7nG6AdUKsqvHT2sdhL/MaciWB5TcG7qTvqSDCNDlRC19CsZ4 -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