Important: This is the documentation for the upcoming Feathers v5 (Dove). See for the current version.

# Configuration

npm version (opens new window) Changelog (opens new window)

npm install @feathersjs/configuration --save

@feathersjs/configuration is a wrapper for node-config (opens new window) which allows to configure a server side Feathers application.

By default this implementation will look in config/* for default.json which retains convention. It will be merged with other configuration files in the config/ folder using the NODE_ENV environment variable. So setting NODE_ENV=production will merge config/default.json with config/production.json.

As per the config docs (opens new window) you can organize "hierarchical configurations for your app deployments".

# Usage

The @feathersjs/configuration module is an app configuration function that takes a root directory (usually something like __dirname in your application) and the configuration folder (set to config by default):

const feathers = require('@feathersjs/feathers');
const configuration = require('@feathersjs/configuration');

// Use the application root and `config/` as the configuration folder
const app = feathers().configure(configuration())

Note: Direct access to nested config properties is not supported via app.get(). To access a nested config property (e.g., use app.get('Customer') or require('config') directly and use it as documented (opens new window).

# Environment variables

As recommended by node-config, it is possible to override the configuration with custom variables by passing a JSON object in the NODE_CONFIG environment variable (opens new window):

$ export NODE_CONFIG='{ "port":  8080, "host": "" }'
$ node myapp.js

Individual environment variables can be used through Custom Environment Variables (opens new window) by creating a config/custom-environment-variables.json like this:

  "port": "PORT",
  "mongodb": "MONGOHQ_URL"

# Configuration directory

By default, Feathers will use the config/ directory in the root of your project’s source directory. To change this, e.g., if you have Feathers installed under the server/ directory and you want your configuration at server/config/, you have to set the NODE_CONFIG_DIR environment variable in app.js before importing @feathersjs/configuration:

$ export NODE_CONFIG_DIR=server/config
$ node myapp.js

Note: The NODE_CONFIG_DIR environment variable isn’t used directly by @feathersjs/configuration but by the node-config (opens new window) module that it uses. For more information on configuring node-config settings, see the Configuration Files Wiki page (opens new window).

# Example

In config/default.json we want to use the local development environment and default MongoDB connection string:

  "frontend": "../public",
  "host": "localhost",
  "port": 3030,
  "mongodb": "mongodb://localhost:27017/myapp",
  "templates": "../templates"

Now it can be used in our app.js like this:

const feathers = require('@feathersjs/feathers');
const configuration = require('@feathersjs/configuration');

const app = feathers().configure(configuration());


Anything unclear or missing? Get help (opens new window) or Edit this page (opens new window)

Last Updated: 3/28/2021, 10:15:45 PM