Import/Export

Both flipt import and flipt export support the --address and --token flags to enable transferring data to and from Flipt instances via the API instead of requiring a direct database connection.

flipt import --address http://flipt.my.org --token static-api-token

flipt export --address grpc://flipt.my.org:9000

Both HTTP and gRPC are supported by the --address flag.

​

Import

To import data into Flipt, use the flipt import command. You can either import from a file or from STDIN.

To import from STDIN, Flipt requires the --stdin flag:

cat flipt.yaml | flipt import --stdin

If not importing using --stdin, Flipt requires the file to be imported as an argument:

flipt import flipt.yaml

This command supports the --drop flag that will drop all data in your Flipt database tables before importing. This is to ensure that no data collisions occur during the import.

See the CLI reference for more information on the import command.

​

Export

To export Flipt data, use the flipt export command.

By default, export will output to STDOUT:

$ flipt export

flags:
- key: new-contact-page
  name: New Contact Page
  description: Show users our Beta contact page
  enabled: true
  variants:
  - key: blue
    name: Blue
  - key: green
    name: Green

You can also export to a file using the -o filename or --output filename flags:

flipt export -o flipt.yaml

By default, Flipt will export from the default namespace. Use the flag --namespaces to export from a different namespace or multiple namespaces.

flipt export --namespaces production

By default, Flipt exports resources in the natural order of the selected storage type. While the output is typically consistent within the same storage type, import/export operations can yield varying results across different storage types. To enhance consistency during export, the --sort-by-key flag can be used.

flipt export --sort-by-key --all-namespaces

See the CLI reference for more information on the export command.