Installation #

Docker #

The simplest way to run Flipt is via Docker. This streamlines the installation and configuration by using a reliable runtime.

Prerequisites #

Docker installation is required on the host, see the official installation docs.

Run the image #

docker run -d \
    -p 8080:8080 \
    -p 9000:9000 \
    -v $HOME/flipt:/var/opt/flipt \

This will download the image and start a Flipt container and publish ports needed to access the UI and backend server. All persistent Flipt data will be stored in $HOME/flipt.

$HOME/flipt is just used as an example, you can use any directory you would like on the host.

The Flipt container uses host mounted volumes to persist data:

Host locationContainer locationPurpose
$HOME/flipt/var/opt/fliptFor storing application data

This allows data to persist between Docker container restarts.

If you don’t use mounted volumes to persist your data, your data will be lost when the container exits!

After starting the container you can visit to view the application.

Download from GitHub #

You can always download the latest release archive for your architecture from the Releases section on GitHub.

This archive contains the Flipt binary, configuration, database migrations, README, LICENSE and CHANGELOG files.

Copy the binary, config file and migrations to an accessible location on your host.

You will need to update the config file: default.yml if your migrations and database locations differ from the standard locations.

Run the Flipt binary with:

./flipt --config PATH_TO_YOUR_CONFIG

See the Configuration section for more details.