Skip to main content
Version: current

Configuration Overview

Falcon Client and Falcon Server configs work in the same way.

Falcon Client configuration can be found in the client/config directory and Falcon Server's config is found in server/config.

The config is set up use NPM Config.

Each of the config files is merged to create your applications configuration.

  • default.json
  • local.json (optional)
  • [NODE_CONFIG_ENV].json (optional)
  • custom-environment-variables.json (optional)

Config priority / order#

The order in which the config files are merged is:

default.json < [NODE_CONFIG_ENV].json < local.json < custom-environment-variables.json


The default.json contains shared config that can be committed to your repository (not passwords and API keys).


The name of this file depends on the config NODE_CONFIG_ENV. For your production environment it would be production.json and would only be loaded on that env. For this reason this file should contain environment specific config.


This file is not committed to your repository. It can contain sensitive data such as API keys and passwords you're using for your application locally.


This file has the highest priority and should be used to map config to environment variables (set on your Node environment). These mapping can be used for sensitive data such as passwords that you wouldn't want committed to your repository.

If you're using Falcon Cloud you can set env variables using the dcloud CLI tool.

CLI Command

dcloud env:var:set <env> <name> [value]
dcloud env:var:set production GTM_CODE XXXXXXXXX


"googleTagManager": {
"id": "GTM_CODE"

Adding encrypted environment variables in DCloud#

If an environment variable such as an API secret key needs to be encrypted you simply need to use the -s or --secret flag when setting it.

dcloud env:var:set -s production GTM_CODE XXXXXXXXX

Ask the community. #help

If you can't find what you're looking for, the answer might be on our community slack channel. Our team keep a close eye on this and will usually get back to you within a few hours, if not straight away. If you haven't created an account yet please sign up here

Stay up to date

Do you want to be informed when we release new features or fixes? Sign up to our newsletter to stay in the loop.