Installation

Install the Fission command line tools to start publishing from your desktop.

Installing the Fission CLI

The Fission command line interface (CLI) is the most common way for developers to interact with Fission services.

macOS with Homebrew

Note: For Apple Silicon (M1) Macs, we are currently unable to provide native CLI builds. Please follow these instructions to run the intel version under Rosetta 2 emulation.

Use the Homebrew recipe to install the CLI on macOS. This taps and installs in one command:

brew install fission-suite/fission/fission-cli

You can also follow the next section for a manual install on macOS.

Linux and Manual Installation

For Windows users, we currently recommend using Windows Subsystem for Linux 2 (WSL2). WSL1 is not supported. Run these Linux / Manual install instructions in your WSL2 environment.

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

Grant execute permissions and move the binary onto to your PATH. For example, on Ubuntu 20.04:

chmod a+x ./fission-cli-ubuntu-20.04
sudo mv ./fission-cli-ubuntu-20.04 /usr/local/bin/fission

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

$ fission --help
Fission makes developing, deploying, updating, and iterating on web apps quick
and easy.

Usage: fission (SHORTCUT | COMMAND | --version) [-v|--verbose]
  CLI to interact with Fission services

If you run into any problems, check that you have libssl1.1 (installed with OpenSSL) and libtinfo5 (or libtinfo6). Most recent Linux distributions will already have these libraries installed.

On macOS, you will also need libcrypto1.1 installed and linked on your system, which should be available from OpenSSL.

Upgrading the CLI

Run fission --version to check if you are using an old version of the CLI.

To upgrade the CLI on macOS, brew uninstall and brew untap to reset brew.

brew uninstall fission-cli
brew untap fission-suite/fission

Reinstall with brew tap and brew install.

brew tap fission-suite/fission
brew install fission-cli

On Linux, repeat the installation steps listed above, leaving out the installation of the additional libraries.