Custom configuration files in NestJS

Introduction

Custom configuration files help you organize settings for your NestJS app. They keep your code clean and make it easy to change settings without touching the main code.

You want to separate database settings from your main code.

You need different settings for development and production.

You want to keep API keys or secrets outside your main code.

You want to easily update app settings without redeploying code.

Syntax

NestJS

import { registerAs } from '@nestjs/config';

export default registerAs('customConfig', () => ({
  key: 'value',
  anotherKey: 123
}));

Use registerAs to create a named configuration file.

The function returns an object with your settings.

Examples

This example creates a database config with connection details.

NestJS

import { registerAs } from '@nestjs/config';

export default registerAs('database', () => ({
  host: 'localhost',
  port: 5432,
  username: 'user',
  password: 'pass'
}));

This example uses environment variables with a fallback value.

NestJS

import { registerAs } from '@nestjs/config';

export default registerAs('api', () => ({
  key: process.env.API_KEY || 'defaultKey',
  timeout: 5000
}));

Sample Program

This module loads the custom config file and prints the value of key from it.

NestJS

import { Module } from '@nestjs/common';
import { ConfigModule, ConfigService } from '@nestjs/config';
import customConfig from './custom.config';

@Module({
  imports: [
    ConfigModule.forRoot({
      load: [customConfig]
    })
  ]
})
export class AppModule {
  constructor(private configService: ConfigService) {
    const value = this.configService.get('customConfig.key');
    console.log('Custom config key:', value);
  }
}

Important Notes

Always keep sensitive data like passwords in environment variables, not in config files.

You can create multiple custom config files and load them all in ConfigModule.forRoot.

Access config values using dot notation with ConfigService.get().

Summary

Custom config files keep your app settings organized and separate from code.

Use registerAs to create named config files that return settings objects.

Load custom configs with ConfigModule.forRoot({ load: [...] }) and access them via ConfigService.

Practice

1. What is the main purpose of using custom configuration files in a NestJS application?

easy

A. To write all logic inside configuration files

B. To keep app settings organized and separate from the main code

C. To replace the main app module

D. To store user data permanently

Solution

1. Step 1: Understand configuration role

   Custom configuration files are used to keep settings like API keys or database info separate from the main code.

2. Step 2: Identify the correct purpose

   This separation helps organize the app and makes it easier to change settings without touching code logic.

3. Final Answer:

   To keep app settings organized and separate from the main code -> Option B

4. Quick Check:

   Custom config files organize settings [OK]

Hint: Custom configs separate settings from code for clarity [OK]

Common Mistakes:

• Thinking config files hold app logic
• Confusing config files with database storage
• Assuming config files replace main modules

2. Which syntax correctly creates a named custom configuration file using registerAs in NestJS?

easy

A. export const config = registerAs('app', () => ({ port: 3000 }));

B. registerAs('app', { port: 3000 });

C. export default registerAs('app', () => ({ port: 3000 }));

D. registerAs('app', () => port: 3000);

Solution

1. Step 1: Understand registerAs usage

   The registerAs function takes a name and a function returning a config object.

2. Step 2: Check syntax correctness

   export const config = registerAs('app', () => ({ port: 3000 })); correctly exports a constant assigned to registerAs with a function returning an object.

3. Final Answer:

   export const config = registerAs('app', () => ({ port: 3000 })); -> Option A

4. Quick Check:

   registerAs needs a name and a function returning an object [OK]

Hint: Use export const with registerAs and a function returning an object [OK]

Common Mistakes:

• Omitting export or const keywords
• Passing object directly instead of a function
• Incorrect arrow function syntax

3. Given this custom config file:

export const databaseConfig = registerAs('database', () => ({ host: 'localhost', port: 5432 }));

And this module setup:

ConfigModule.forRoot({ load: [databaseConfig] })

What will configService.get('database.host') return?

medium

A. Error: Config not found

B. 'database.host'

C. undefined

D. 'localhost'

Solution

1. Step 1: Understand config loading

   The databaseConfig is loaded into ConfigModule with load, making its keys accessible.

2. Step 2: Access nested config value

   Using configService.get('database.host') accesses the 'host' key inside the 'database' config, which is 'localhost'.

3. Final Answer:

   'localhost' -> Option D

4. Quick Check:

   Nested config keys return their values [OK]

Hint: Use dot notation to get nested config values [OK]

Common Mistakes:

• Expecting the whole object instead of a value
• Using wrong key names
• Not loading config before accessing

4. What is wrong with this custom config file code?

export const appConfig = registerAs('app', () => { port: 3000 });

medium

A. The config name 'app' is invalid

B. Missing import of registerAs

C. The arrow function does not return the object properly

D. The port value must be a string

Solution

1. Step 1: Check arrow function return

   The arrow function uses curly braces without a return statement, so it returns undefined instead of the object.

2. Step 2: Correct syntax for returning object

   To return an object directly, wrap it in parentheses: () => ({ port: 3000 }).

3. Final Answer:

   The arrow function does not return the object properly -> Option C

4. Quick Check:

   Arrow functions need parentheses to return objects directly [OK]

Hint: Wrap object in parentheses to return from arrow function [OK]

Common Mistakes:

• Using curly braces without return in arrow functions
• Assuming config name must be special
• Thinking port must be string

5. You want to create two custom config files, appConfig and dbConfig, and load both in your NestJS app. Which setup correctly loads and accesses the dbConfig.username value?

hard

A. Load both configs in ConfigModule.forRoot({ load: [appConfig, dbConfig] }) and get with configService.get('dbConfig.username')

B. Load only appConfig and get dbConfig.username directly

C. Load both configs but access dbConfig.username with configService.get('username')

D. Load configs separately in different modules without forRoot

Solution

1. Step 1: Load multiple configs together

   Use ConfigModule.forRoot({ load: [appConfig, dbConfig] }) to load both custom configs at app start.

2. Step 2: Access nested config by namespace

   Access dbConfig.username using configService.get('dbConfig.username') because configs are namespaced by their registration name.

3. Final Answer:

   Load both configs in ConfigModule.forRoot({ load: [appConfig, dbConfig] }) and get with configService.get('dbConfig.username') -> Option A

4. Quick Check:

   Load all configs and use namespaced keys to access [OK]

Hint: Load all configs in forRoot and use dot keys to access [OK]

Common Mistakes:

• Loading only one config but accessing another
• Accessing keys without namespace prefix
• Trying to load configs outside forRoot