Skip to main content
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.
Flipt requires Docker Engine version 20.10 or higher.

​
Running

docker run -d \
    -p 8080:8080 \
    -p 9000:9000 \
    -v $HOME/flipt:/var/opt/flipt \
    docker.flipt.io/flipt/flipt:latest
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 http://127.0.0.1:8080 to view the application.
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 the docker run command to mount your local configuration into the container: 
docker run -d \
    -p 8080:8080 \
    -p 9000:9000 \
    -v $HOME/flipt:/var/opt/flipt \
    -v $HOME/flipt/config.yaml:/etc/flipt/config/default.yml \
    docker.flipt.io/flipt/flipt:latest