Supported Architectures
Flipt v2 is built for the following architectures/os:- x86-64 / Linux
- ARM64 / Linux
- x86-64 / Darwin/MacOS
- ARM64 / Darwin/MacOS
Docker
Docker installation is required on the host, see the official installation docs.Flipt requires Docker Engine version
20.10 or higher.
Running
$HOME/flipt
.
$HOME/flipt
is just used as an example, you can use any directory you would
like on the host.Host location | Container location | Purpose |
---|---|---|
$HOME/flipt | /var/opt/flipt | For storing application data |
If you donβt use mounted volumes to persist your data, your data will be lost
when the container exits!
Flipt runs without the root user in the Docker container.
Configuration
A default configuration file is included within the image. To supply a custom configuration, update thedocker run
command to mount your local configuration into the container:
Homebrew
You can install Flipt v2 using Homebrew on macOS and Linux.If you have Flipt v1 installed via Homebrew, youβll need to unlink it first:
brew unlink flipt
Installing
Running
Once installed, you can run Flipt v2 with:Binary
You can always download the latest release archive of Flipt v2 from the Releases section on GitHub.Installing
You can use the following script to download and install the latest Flipt binary:/usr/local/bin/flipt
on Mac and Linux systems.
View the install.sh source for more details.
Running
Run the Flipt server with:--config
flag as an override{{ USER_CONFIG_DIR }}/flipt/config.yml
(theUSER_CONFIG_DIR
value is based on your architecture and specified in the Go documentation)/etc/flipt/config/default.yml
Kubernetes/Helm
Deploy Flipt v2 to Kubernetes using the official Helm chart. This method is ideal for production deployments and provides easy configuration management.Prerequisites
- Kubernetes cluster (local or remote)
- Helm v3.x installed
kubectl
configured to access your cluster
Installing
Add the Flipt Helm repository and install Flipt v2:The chart name is
flipt-v2
, which is separate from the v1 flipt
chart.
This ensures v2-specific configurations and compatibility.Key Features
Flipt v2βs Helm chart includes:- Git-native storage: Works out-of-the-box without external databases
- Environment support: Deploy multiple environments from different Git branches
- Flexible configuration: Support for all v2 configuration options
- Production ready: Includes security, observability, and scaling options
Configuration
Create avalues.yaml
file to customize your deployment:
This example showcases common v2 configuration options including CORS, UI
customization, and observability settings. For production use with Git-backed
storage, see the Git Storage
guide.