is a platform for running applications close to users. This guide will show you how to deploy Flipt to and configure Flipt to use a Postgres database, also managed by

What You’ll Learn

In this guide, you will learn how to deploy Flipt to with Postgres. You’ll also learn how to configure Flipt with environment variables.

By the end of this guide, we will have:

  • 🚀 Successfully deployed Flipt to
  • 🐘 Configured Flipt with environment variables to use’s managed Postgres service


Deployment Steps

  1. Ensure you can log in to your account with fly auth login.
  2. Create and cd into a new directory for your Flipt deployment. (e.g. mkdir flipt-test && cd flipt-test)
  3. Begin the launch process to deploy Flipt on using their CLI, selecting mainly the defaults and Postgres when prompted:

We specify the image, which is the latest stable release of Flipt. You can also use a specific version of Flipt by replacing latest with a specific version tag (e.g.

$ fly launch -i

? App Name (leave blank to use an auto-generated name) flipt-test

Automatically selected personal organization: <your-org>


? Would you like to set up a Postgresql database now? Yes

Note the Postgres database connection string that’s printed during the launch process. You will need this to configure Flipt.

  1. After the launch process completes, it will write a fly.toml file to your current directory. You can configure the number of instances, memory, and CPU allocated to your Flipt deployment. You can also set environment variables to customize Flipt’s configuration.

    For more information, refer to the documentation and the Flipt documentation.

  2. Before deploying Flipt, we’ll need to set the FLIPT_DB_URL secret to point to your newly configured Postgres database.

    You can do this with the following command, replacing <your-db-url> with the connection string from the launch process and appending the db name (postgres) and ?sslmode=disable:

fly secrets set FLIPT_DB_URL=<your-db-url>/postgres?sslmode=disable
  1. Finally, deploy Flipt to with fly deploy.
$ fly deploy

Deploying flipt-test
==> Validating App Configuration

Verifying the Deployment

After deployment, you can verify if Flipt is running correctly by accessing the Flipt UI on the provided URL or issue the command fly open in the CLI to open your newly deployed Flipt instance in the browser.

$ fly open

opening ...

Flipt UI


You can configure Flipt with environment variables in the fly.toml file. For example, to configure Flipt to use a custom port and enable DEBUG logging you can add the following to the fly.toml file:

# See for information
# about how to use this file.

app = "flipt-test"
primary_region = "iad"

  image = ""

  internal_port = 9090
  force_https = true

  FLIPT_LOG_LEVEL = "debug"

After making changes to the fly.toml file, you can deploy the changes with fly deploy.

$ fly deploy

Deploying flipt-test
==> Validating App Configuration


If you encounter any issues during the deployment, check the logs on for any error messages:

fly logs

Enabling DEBUG logging as shown above can be helpful for troubleshooting any issues during Flipt startup.


Deploying Flipt to allows you to get up and running with Flipt quickly. For production deployments however, you’ll likely want to configure Flipt with authentication as well as consider configuring caching, observability, and using a read replica for your database.

For more information on production deployments, refer to the Deployment section of the documentation.