Flipt is a single binary that can be run on any Linux or macOS (arm64) host. You can install and try out Flipt in a few different ways:

For more details on each installation method, see the sections below.

Flipt Cloud

Don’t want to self-host? Learn more about our cloud offering.

Homebrew

You can install Flipt using Homebrew on macOS and Linux.

Flipt runs as a service and is managed by Homebrew Services. This means you can start and stop Flipt using the brew services command.

Installing

brew install flipt-io/brew/flipt

Running

brew services start flipt

Alternatively, you can start Flipt in the foreground using:

flipt

Binary

You can always download the latest release archive of Flipt from the Releases section on GitHub.

Installing

You can use the following script to download and install the latest Flipt binary:

curl -fsSL https://get.flipt.io/install | sh

This will install Flipt to /usr/local/bin/flipt on Mac and Linux systems.

View the install.sh source for more details.

Running

Run the Flipt binary with:

flipt [--config OPTIONAL_PATH_TO_YOUR_CONFIG]

Flipt will check in a few different locations for server configuration (in order):

  1. --config flag as an override
  2. {{ USER_CONFIG_DIR }}/flipt/config.yml (the USER_CONFIG_DIR value is based on your architecture and specified in the Go documentation)
  3. /etc/flipt/config/default.yml

See the Configuration section for more details.

Supported Architectures

Flipt is built for the following architectures/os:

  • x86-64 / Linux
  • ARM64 / Linux
  • x86-64 / Darwin/MacOS
  • ARM64 / Darwin/MacOS

You can find the binaries for each architecture in the Latest Release assets section on GitHub.

The Docker image for Flipt is multi-arch and supports both x86-64 and ARM64 architectures on Linux.

If you need a different architecture, please open an issue on the GitHub repository and we will try to accommodate your request.