diff --git a/docs/step_by_step.rst b/docs/step_by_step.rst
index afa11a8f4..21903a73b 100644
--- a/docs/step_by_step.rst
+++ b/docs/step_by_step.rst
@@ -224,7 +224,7 @@ Luna 已改为纯前端，需要 Nginx 来运行访问
 
     # 注意：这里一定要改写一下本机的IP地址, 否则会出错
 
-    docker run -d \
+    docker run --name jms_guacamole -d \
       -p 8081:8080 -v /opt/guacamole/key:/config/guacamole/key \
       -e JUMPSERVER_KEY_DIR=/config/guacamole/key \
       -e JUMPSERVER_SERVER=http://<填写本机的IP地址>:8080 \
diff --git a/docs/upgrade.rst b/docs/upgrade.rst
index 2a11a6288..2b423dfd5 100644
--- a/docs/upgrade.rst
+++ b/docs/upgrade.rst
@@ -1,5 +1,5 @@
-升级
-----
+更新升级
+-------------
 
 1. 升级 Jumpserver
 
@@ -22,8 +22,121 @@
 :: 
 
     $ docker pull registry.jumpserver.org/public/guacamole:latest
-    $ docker stop <guacamole>
-    $ docker run -d \
-      -p 8081:8080 \
+    $ docker stop jms_guacamole  # 或者写guacamole的容器ID
+    $ docker run --name jms_guacamole -d \
+      -p 8081:8080 -v /opt/guacamole/key:/config/guacamole/key \
+      -e JUMPSERVER_KEY_DIR=/config/guacamole/key \
       -e JUMPSERVER_SERVER=http://<填写本机的IP地址>:8080 \
       registry.jumpserver.org/public/guacamole:latest
+
+
+切换分支或离线升级
+-------------------------------
+
+
+**Jumpserver**
+
+说明: 以下操作，都在jumpserver所在目录运行
+
+1. 备份配置文件
+
+::
+
+    $ jumpserver_backup=/tmp/jumpserver_backup
+    $ mkdir -p $jumpserver_backup
+    $ cp config.py $jumpserver_backup
+
+2. 备份migrations migrations中存的是数据库表结构的变更，切换分支会丢失
+
+::
+
+   $ for app in common users assets ops perms terminal;do
+      mkdir -p $jumpserver_backup/${app}_migrations
+      cp apps/${app}/migrations/*.py $jumpserver_backup/${app}_migrations
+   done
+
+
+3. 备份数据库，已被不时之需
+
+::
+
+  $ mysqldump -u你的数据库账号 -h数据库地址 -p 数据库名称 > $jumpserver_backup/db_backup.sql
+
+4. 备份录像文件
+
+::
+
+   $ cp -r data/media $jumpserver_backup/
+
+5. 切换分支或下载离线包, 更新代码
+
+::
+
+   $ git checkout master  # or other branch
+
+
+6. 还原配置文件
+
+::
+
+   $ cp $jumpserver_backup/config.py .
+
+7. 还原数据库表结构记录
+
+::
+
+   $ for app in common users assets ops perms terminal;do
+      cp $jumpserver_backup/${app}_migrations/*.py ${app}/migrations/
+   done
+
+8. 还原录像文件
+
+::
+
+   $ cp -r $jumpserver_backup/media/* data/media/
+
+9. 更新依赖或表结构
+
+::
+   $ pip install -r requirements/requirements.txt && cd utils && sh make_migrations.sh
+
+
+**Coco**
+
+说明: 以下操作都在 coco 项目所在目录
+
+coco是无状态的，备份 keys 目录即可
+
+1. 备份keys
+
+::
+
+   $ cp -r keys $jumpserver_backup/
+
+
+2. 离线更新升级coco
+
+3. 还原 keys目录
+
+::
+
+   $ mv keys keys_backup
+   $ cp -r  $jumpserver_backup/keys .
+
+4. 升级依赖
+
+::
+
+   $ git pull && cd requirements && pip install -r requirements.txt
+
+
+**Luna**
+
+直接下载最新Release包替换即可
+
+
+**Guacamole**
+
+直接参考上面的升级即可, 需要注意的是如果更换机器，请备份
+
+