Last update: 3 minutes ago by Alejandro SantistebanReading time: 4 min


The infrastructure and microservices are already configured to work straight away and be connected (docker or node). All the infrastructure will be exposed so no docker network is needed. All the components will be deployed locally using the following ports:


The default configuration of the infrastructure is available here.

Deploying the system using Docker-Compose

The prerequisites for deploying the system are:

  • Git for cloning the repository
  • Docker (v20.0.0 or greater) and docker-compose (v1.25.0 or greater) installed
  • Having the ports showed up in the last section available.


  1. In case you are running a linux machine, you need to asociate the host.docker.internal url to (docker's gateway)
host-manager -add host.docker.internal
  1. Clone the repository and checkout to the develop branch:
git clone
cd falcon-infrastructure
git checkout origin/develop
  1. Deploy the system
docker-compose -f ./docker-compose-local.yaml --env-file ./.env-local up -d

Bear in mind that any key or configuration can be setted up in the .env-local file instead of .env. On any docker-compose-local.yaml or .env-local change, run the step 2 again it order for it to take place. Also any service deployed with node won't use the .env-local variables so make sure they are properly configured.

Quick tour

The main interaface is accesible from the UI on http://localhost:5100.

The default credentials for this interface are:

  • User: governify-admin
  • Password: governify-project
This credentials can be changed in the .env-local file.

In this interface you should be able to see the infrastructures that are being monitored. At first, it will display a card showing a message .

No infrastructure being monitored
No infrastructure being monitored

To start monitoring any infrastructure, check the adding infrastructures section. After setting up the configuration for one infrastructure, you should see a card displayed in the user interface at ui.falcon.[YourDomain].

Infrastructure being monitored
Infrastructure being monitored

After clicking the ANS button, a new tab will open and the SLA view of the project should appear. It contains information about the infrastucture being monitored along the guarantees and metrics in use.

TPA view

To calculate data for this infrastructure, the top-right blue button Calculate Metrics has to be clicked. A window will pop-up asking for confirmation, since the previous records will be deleted.

Note that Falcon is intended for monitoring and thus, the automatic computation is more suitable in this case. It is strongly recommended to leave automatic computation turned on in case you want to continously keep records of your infrastructure's metrics.

Clicking the Dashboard green button at the top-right corner, a new tab will open. The default username and password are governify-admin and governify-project.

This credentials can be changed, once logged, going to the icon in the bottom left part of the Dashboard, clicking on preferences, and accessing the section Change password at the top of the page.

Once logged, the dashboard for the project will be opened where all the audit data can be viewed.

Dashboard of Bluejay response times
Dashboard of Bluejay response times

Now is time to configure your own projects in order to audit them.


Here are contained all configuaration variables. Enter here your tokens for the different APIs for the Event Collector to use it by default if it is not given for the project in the scope.json file.

Develop a feature in an existing microservice

To develop a feature is as simple as shutting the container down and then starting the microservice cloned from GitHub. E.g. If the collector-dynamic wants to be modified:

  1. Stop the container:
docker stop falcon-collector-dynamic
  1. Clone and start the microservice:
git clone
cd collector-dynamic
npm i
node index

It will start in the same port as the container was and will be properly connected to the entire infrastructure.

Deploying the system in a Kubernetes cluster

Governify provides Helm charts for deploying Falcon services inside a Kubernetes cluster. The following steps describe how to deploy the infrastructure inside a development cluster (or a single-node cluster like minikube):

  1. Create Namespace
$ kubectl create namespace governify-falcon
  1. Configure kubernetes for assigning NodePorts in range (3000-9000) by adding --service-node-port-range=3000-6000 to the kubernetes kube-apiserver config file. If using docker-desktop check this page.

  2. Create a values.yaml file with the following content

node_env: development
gov_infrastructure: <assets_call_to_infrastructure-local.yaml>
login_user: <username>
login_password: <password>
gov_infrastructure: <local_path_to_infrastructure-local.yaml>
assets_repository: <repository_url> (defaults to current assets repository inside github governify organization)
assets_repository_branch: <branch> (default: main)
  1. Install charts
$ helm repo add governify
$ helm repo update
$ helm install -f values.yaml <release_name> governify/<chart_name>

More information about the configuration options available for Governify-Falcon HELM chart can be found at our HELM Charts repository.

Next — 🛠 Development