Overview

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.

• Docker
• Kubernetes
• Homebrew
• Binary

​

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.