Data Management:Custom environment variables in Dify

Usage notes

• Service restart: Saving any changes to environment variables triggers an automatic restart of your Dify instance, causing a brief service interruption. Perform this operation during off-peak hours.

• Whitelist restriction: Only variables listed in Supported environment variables can be modified.

• Format requirement: All parameters must be provided as JSON key-value pairs ("Key": "Value"). All values must be strings.

Prerequisites

Before you begin, ensure that you have:

• A Dify instance in the DMS console

• The required permissions to manage the Dify instance

Set environment variables

1. Log on to the DMS console. In the top navigation bar, choose Data + AI > Dify to open the Dify instance list.

   

2. In the Actions column for your Dify instance, click Resource Management.

   

3. In the Resource Management interface, click Environment Parameters.

   

4. In the Environment Parameters Configuration dialog box, modify or add environment variables:

   • Modify an existing variable: Edit the value directly in the input field. To restore a variable to its default, delete the entire key-value pair — the system applies the default after you save.

   • Add a new variable: Some whitelisted variables are not shown by default and must be added manually. The following example configures a custom domain. Add the key-value pairs below, replacing my_web.com with your domain.

     Note

     CONSOLE_API_URL, CONSOLE_WEB_URL, and APP_WEB_URL are modifiable only in Dify Account Edition and Enterprise Edition.

     {
       "HTTP_REQUEST_NODE_MAX_TEXT_SIZE": "1048576",
       ...
       "CONSOLE_API_URL": "http://my_web.com",
       "APP_API_URL": "http://my_web.com",
       "CONSOLE_WEB_URL": "http://my_web.com",
       "APP_WEB_URL": "http://my_web.com",
       "FILES_URL": "http://my_web.com"
     }

   

5. Click Save, then click Confirm in the confirmation dialog box.

6. After saving, the system redeploys the instance. Check the result in the bottom-right corner:

   • Success: Three notifications appear in sequence: Environment parameters validated successfully, Environment parameters updated successfully, and Redeployment started. The Dify instance is restarting.

   • Failure: An error such as Env key 'xxxx' is invalid indicates that the key xxxx is incorrect. Verify that the key is in the whitelist and spelled correctly.

Supported environment variables