The simplest way to run Flipt is via Docker. This streamlines the installation and configuration by using a reliable runtime.
Docker installation is required on the host, see the official installation docs.
Using a native Docker install instead of Docker Toolbox is recommended in order to use persisted volumes.
Run the image
docker run -d \ -p 8080:8080 \ -p 9000:9000 \ -v $HOME/flipt:/var/opt/flipt \ markphelps/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 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 location||Container location||Purpose|
|$HOME/flipt||/var/opt/flipt||For 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://0.0.0.0:8080 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.