Skip to main content

Installation

Interested in trying Formance Stack out? The simplest way is to create yourself a cloud sandbox using fctl, the Formance CLI for creating and managing Formance deployments in the cloud. And, as you'd expect, it's available for Linux, macOS, and Windows.

We also provide Docker images and Helm charts for local and cloud native deployments. You can learn more about all the different ways of installing Formance Stack in the reference installation page.

Homebrew​

If you have Homebrew installed on your computer, you can install the CLI by running:

brew install formancehq/tap/fctl

To upgrade an existing installation of the Formance CLI, run:

brew upgrade fctl

Binary​

Binaries for fctl are available for Linux, macOS, and Windows. You can download the latest release from the GitHub releases page.

# You can use either amd64 for x86_64 or arm64 for ARM
ARCH="amd64"; curl -L -o fctl.tar.gz "https://github.com/formancehq/stack/releases/download/components%2Ffctl%2Fv0.8.2/fctl_linux-$ARCH.tar.gz" \
&& tar -xvf fctl.tar.gz \
&& sudo mv fctl /usr/local/bin \
&& chmod +x /usr/local/bin/fctl \
&& rm fctl.tar.gz

Debian/Ubuntu​

First, you'll need to add the Formance's package repository to your /etc/apt/sources.list:

/etc/apt/sources.list
deb [trusted=yes] https://apt.fury.io/formance/ /

Then, you can run this command to install Formance CLI:

apt update && apt install fctl

Troubleshooting​

You can check that Formance CLI was installed correctly by trying the following command:

fctl version

You should see something like

Version | 0.5.1
Date    | 2022-11-28T09:40:15Z
Commit  | 0de953f

If you don't, then recheck the steps above, or reach out to us to ask for help.