Backend Installation

Plain Flags may be installed in a few possible variants:

  • Self hosted on your machine (for example a VPS or a server in your own datacenter) using Docker images.
  • In Google Cloud using the source code and gcloud command line tool.
  • In Google Cloud using the provided Terraform module to set up the feature flags infrastructure alongside your other infrastructure.

Using Docker Images On Your Infrastructure

Plain Flags back end is best installed and run as Docker containers. Below are two examples.

Available PlainFlags container images work on Linux AMD64 and ARM64 architectures.

In Google Cloud Using gcloud From Source Code

Clone or download the source code from the git repository.

Change directory to gcp and follow the instructions in the README file.

There are requirements regarding your own cloud environment.

Plain Flags provides convenient shell scripts to configure and set up the feature flags services and databases and required accounts and permissions.

The GCP variant of Plain Flags uses Firebase Auth to manage your Plain Flags users.

The gcp/infrastructure folder includes a helper script to facilitate the creation of a Firebase web app for your feature flag user management.

In Google Cloud Using Terraform

Plain Flags provides a Terraform module to set up the feature flags alongside your other infastructure.

Here is an example of integration of Plain Flags into another Terraform setup as a module:

https://github.com/andreileonte1981/plain-flags-demo/tree/master/gcp/terraform

The GCP variant of Plain Flags uses Firebase Auth to manage your Plain Flags users.

Download these shell scripts and run them locally as instructed for an easy setup of Firebase for Plain Flags:

https://github.com/andreileonte1981/plain-flags/blob/main/gcp/infrastructure/terraform/setup-firebase-app.shhttps://github.com/andreileonte1981/plain-flags/blob/main/gcp/infrastructure/terraform/setup-firebase-auth.sh

The SDK

To use the Plain Flags SDK, install it as follows:
NodeJs (TypeScript)
npm install plain-flags-node-sdk
Go (Golang)
go get github.com/andreileonte1981/plain-flags/sdk/go
Python
pip install plain-flags-sdk
Dart / Flutter
dart pub add plain_flags

Source Code

Plain Flags source code is freely available.

You can choose to build and run your own installation from the source code: github repository

Mobile Dashboard App