Windows

Installation instructions for IPFS and Fission on Windows, including Windows Subsystem for Linux and native Windows exe

Native Windows Executable

We are currently in the alpha stage of development and expect to have a native Windows executable ready shortly.

In the meantime, continue reading to learn how to access Fission CLI using Windows Subsystem for Linux (WSL) today!

Fission on Windows Subsystem for Linux (WSL)

WSL on Windows 10 offers an easy way to get started with Fission CLI.

To differentiate between operating system commands:

  • > indicates Windows

  • $ indicates Linux

Enabling WSL

WSL is disabled by default so if you have never used it before, the first step will be enabling the optional feature. Open PowerShell as Administrator and enter the following:

> Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux

After restarting your computer, you'll be ready for the next step.

Adding a Linux Distribution

Before using WSL, you need to add a Linux distribution. Run PowerShell as Administrator and enter the following command:

> choco install wsl-ubuntu-1804
> wsl --list

If the installation was successful then Ubuntu should be listed.

If you have multiple distributions installed, the above command (wsl --list) will display your default distribution. It's important to know which one you're working in because each distribution is completely isolated.

Installing IPFS

We recommend installing IPFS from a prebuilt package. First, download the 64-bit Linux package for your platform.

Enter WSL, untar the archive, and run the ./install.sh script (which just moves the binary to your local Linux bin path).

> wsl
$ tar xvfz go-ipfs.tar.gz
$ cd go-ipfs
$ ./install.sh

Test it out

$ ipfs help
USAGE:
ipfs - Global p2p merkle-dag filesystem.
...

For more installation options, check out the Install IPFS guide.

Installing Fission

Head over to our releases page on Github and download the latest release for your operating system.

Unzip the file into your Windows Downloads folder then open PowerShell as Administrator and run the following commands:

> cd ~\Downloads
> wsl
$ pwd

The output of pwd should show/mnt/c/Users/<username>/Downloads which is the mounting point of your Windows Downloads folder in Linux. Now you can move the binary to your Linux PATH:

$ mv ./fission-cli-exe /usr/local/bin/fission

Linux requires an additional dependency:

$ apt update
$ apt install libpq-dev

That's it! Double check that it's installed correctly:

$ fission --help
CLI to interact with Fission services
Usage: fission [--version] [--help] COMMAND
Fission makes developing, deploying, updating and iterating on web
applications quick and easy.
...