All Products
Search

This Product

    Data Management:Upgrade Dify on DMS

    Document Center

    Data Management:Upgrade Dify on DMS

    Last Updated:Jan 15, 2026

    Data Management Service (DMS) allows you to perform a major version upgrade of Dify on DMS from v0.15.3 or earlier to v1.1.3. This upgrade provides access to the latest plugin ecosystem features. Follow the instructions in this topic to complete the process.

    Important Notes

    This feature is in Preview. To use it, please contact DMS Technical Support.

    Prerequisites

    Before upgrading Dify on DMS, back up all Dify-related resources to prevent data loss. You must also create a dify_plugin database in your target ApsaraDB RDS for PostgreSQL instance, which will manage the metadata for installed plugins.

    Back up data

    Back up the ApsaraDB RDS for PostgreSQL and vector databases that Dify uses.

    Back up ApsaraDB RDS for PostgreSQL instance

    1. Go to the Instances page. In the top navigation bar, select the region in which the RDS instance resides. Then, find the RDS instance and click the ID of the instance.

    2. In the upper-right corner of the page, click Backup Instance. In the dialog box that appears, click OK.

    3. In the upper-right corner, click Tasks to check the backup status.

      The backup is complete when the task progress reaches 100%.

    Back up vector database

    The following steps use an AnalyticDB for PostgreSQL instance as an example.

    1. Log on to the AnalyticDB for PostgreSQL console.

    2. In the upper-left corner of the console, select the region where the instance is located.

    3. Find and click the ID of the target instance. In the navigation pane on the left, click Backup and Restoration.

    4. In the upper-right corner of the page, click Create Backup, and then click OK.

      The backup is complete when the task status is Success.

    Click to view the vector databases supported by Dify on DMS

    AnalyticDB for PostgreSQL, AnalyticDB for MySQL, PolarDB for PostgreSQL, RDS PostgreSQL, and Lindorm.

    Prepare the database

    Modify the password for the dify_user account in the Tair (Redis OSS-compatible) console, ensuring it matches the default account's password.. Then, create a dify_plugin database in the target ApsaraDB RDS for PostgreSQL instance.

    Note

    The dify_user is a database account that DMS automatically creates on the corresponding instance during Dify's deployment.

    Verify the database account password in Redis

    Confirm that the default account's password matches the dify_user's password. If they do not match, please modify the password of the dify_user account.

    If you have modified the dify_user account's password, you will need to update the database password on the DMS instance editing page. Follow these steps:

    1. Log on to the DMS console V5.0.

    2. In the database instance list on the left, find the target instance, right-click the instance name, and click Edit.

    3. Ensure that Security hosting is Enable. Then, re-enter the Database Password for the dify_user account, and click Save.

    Create the dify_plugin database in ApsaraDB RDS for PostgreSQL

    1. Go to the RDS Instance List. Select a region at the top of the page, and then click the ID of the target instance.

    2. In the navigation pane on the left, click Database Management, and then click Create Database.

      For Database Name, enter dify_plugin. For Authorized Account, select dify_user.

    3. Click Create.

    Upgrade Dify on DMS

    1. Log on to the DMS console V5.0.

    2. Move the pointer over the 2023-01-28_15-57-17.png icon in the upper-left corner and choose All Features > Data+AI > Workspace.

      Note

      If you do not use the DMS console in Simple mode, choose Data+AI > Workspace in the top navigation bar.

      image

    3. Click the workspace name to enter the workspace.

    4. In the navigation pane on the left, choose image > Dify, and then click Upgrade to Latest Version.

      Note

      The upgrade process takes approximately 10 minutes, during which the Dify service—including models deployed through Dify and applications created in the Studio—will be unavailable.

    5. After the upgrade is complete, you can use the latest version of Dify.

      To verify the upgrade, click the avatar in your Dify space and check the version in the About area.

    Install Dify plugins

    1. After the upgrade is complete, in the navigation pane on the left of the Workspace, click Dify > Studio.

    2. In the upper-right corner, click Plugins, and then click Install Plugin.

      The supported plugin sources include Marketplace, GitHub, and Local Package File, DMS Plugin.

    3. Select a suitable source and install the plugins you need, such as model plugins, tool plugins, and agent strategy plugins.

      Note

      After the plugin installation is complete, if your existing Dify application uses model services or knowledge base retrieval, you will need to reconfigure the corresponding models or knowledge bases.

      For example, you can install the latest version of the Tongyi Qianwen plugin from the Marketplace.

    4. Continue to develop your large model applications. For detailed instructions, see the official Dify documentation.