All Products
Search
Document Center

Microservices Engine:Create a configuration

Last Updated:Mar 11, 2026

Nacos configurations let you externalize application settings -- such as feature flags, connection pools, and log levels -- so you can update them at runtime without redeploying code. Each configuration is identified by a unique combination of Data ID, Group, and Namespace.

Prerequisites

Before you begin, make sure that you have:

Create a configuration in the console

  1. Log on to the MSE console and select a region in the top navigation bar.

  2. In the left-side navigation pane, choose Microservices Registry > Instances.

  3. On the Instances page, click the name of the instance.

  4. In the left-side navigation pane, choose Configuration Management > Configurations.

  5. On the Configurations page, select a namespace from the Namespace drop-down list in the upper-left corner, then click Add Configuration.

  6. In the Add Configuration panel, set the following parameters, then click Release.

    ParameterRequiredDescription
    Region--Auto-populated from the current Nacos instance. Cannot be changed.
    Namespace--Auto-populated from the namespace selected in step 5. Cannot be changed.
    Data IDYesA unique identifier for the configuration within its group. Use the package.class naming convention, such as com.foo.bar.log.level.
    GroupYesA logical grouping for related configurations. Use a product name or module name, such as order-service or payment-module. Must be unique.
    Data EncryptionNoEncrypts the configuration content to protect sensitive values such as database credentials. When enabled, the Data ID is automatically prefixed with cipher-. For more information, see Configure encryption.
    Configuration FormatYesThe data format: Properties, JSON, YAML, XML, or plain text.
    DescriptionNoA brief note describing the purpose of this configuration.
    More Settings > ApplicationNoThe application that uses this configuration.
    More Settings > Configuration TagNoTags for filtering and organizing configurations. Type a keyword and select from the drop-down list.
    Configuration ContentYesThe configuration data, entered in the right-side panel. For example: threadPoolSize=5 and logLevel=WARN.

After you click Release, the configuration appears on the Configurations page.

Configuration content examples

Application settings (Properties format)

# Database connection pool
db.pool.maxActive=20
db.pool.minIdle=5
db.pool.maxWait=60000

# Logging
log.level=WARN
log.path=/var/log/app

Feature flags (JSON format)

{
  "features": {
    "new_checkout_flow": {
      "enabled": true,
      "rollout_percentage": 25
    },
    "dark_mode": {
      "enabled": false
    }
  }
}

Service endpoint configuration (YAML format)

upstream:
  payment-service:
    url: https://pay.example.com/api/v2
    timeout: 3000
    retries: 3
  inventory-service:
    url: https://inv.example.com/api/v1
    timeout: 5000
    retries: 2

Limits

Configuration typeMaximum size
Non-encrypted100 KB
Encrypted50 KB

If a configuration exceeds these limits, split it into multiple smaller configurations. To request a larger quota, go to Quota Center.

Important

Changing the content size limit may affect Nacos stability. Evaluate the impact before you request a quota adjustment.