diff --git a/docs/zh/14-reference/01-components/04-taosx.md b/docs/zh/14-reference/01-components/04-taosx.md
index 114a6b1ce5..4386d49b22 100644
--- a/docs/zh/14-reference/01-components/04-taosx.md
+++ b/docs/zh/14-reference/01-components/04-taosx.md
@@ -282,9 +282,6 @@ d4,2017-07-14T10:40:00.006+08:00,-2.740636,10,-0.893545,7,California.LosAngles
 # listen to ip:port address
 #listen = "0.0.0.0:6050"
 
-# database url
-#database_url = "sqlite:taosx.db"
-
 # default global request timeout which unit is second. This parameter takes effect for certain interfaces that require a timeout setting
 #request_timeout = 30
 
@@ -384,6 +381,16 @@ Linux 下 `journalctl` 查看日志的命令如下：
 journalctl -u taosx [-f]
 ```
 
+### 从旧版本升级
+
+从 3.3.5.0/3.3.4.11 版本开始，不再在 systemd 服务文件预置 `DATABASE_URL=` 环境变量。如果在配置文件中使用了自定义 `data_dir` 参数，从旧版本升级后，必须将数据库文件从旧版本移动到自定义目录中。以 `data_dir = "/path/to/data"` 为例，执行以下命令：
+
+```shell
+mv /var/lib/taos/taosx/taosx.db* /path/to/data/
+```
+
+之后再重启服务（此行为仅影响 Linux 系统）。
+
 ## taosX 监控指标
 
 taosX 会将监控指标上报给 taosKeeper，这些监控指标会被 taosKeeper 写入监控数据库，默认是 `log` 库，可以在 taoskeeper 配置文件中修改。以下是这些监控指标的详细介绍。