Skip to content

RAGFlow is an agent-native database: a Retrieval-Augmented Generation (RAG) engine that grew into context infrastructure.

docs: restructure the admin docs to make it more user friendly (#21279)

YanZhang3f125e249125
diff --git a/docs/administrator/admin/_category_.json b/docs/administrator/admin/_category_.json
deleted file mode 100644
index e6b4068b3c..0000000000
--- a/docs/administrator/admin/_category_.json
+++ /dev/null
@@ -1,11 +0,0 @@
-{
- "label": "Admin Service",
- "position": 3,
- "link": {
- "type": "generated-index",
- "description": "RAGFlow administration service"
- },
- "customProps": {
- "categoryIcon": "LucideUserCog"
- }
-}
diff --git a/docs/administrator/configurations/_category_.json b/docs/administrator/configurations/_category_.json
deleted file mode 100644
index bc3ce14998..0000000000
--- a/docs/administrator/configurations/_category_.json
+++ /dev/null
@@ -1,8 +0,0 @@
-{
- "label": "Configurations",
- "position": 0,
- "link": {
- "type": "generated-index",
- "description": "Guides for system configurations"
- }
-}
diff --git a/docs/administrator/management/_category_.json b/docs/administrator/management/_category_.json
new file mode 100644
index 0000000000..ad97f9bb5e
--- /dev/null
+++ b/docs/administrator/management/_category_.json
@@ -0,0 +1,11 @@
+{
+ "label": "Admin Tools",
+ "position": 1,
+ "link": {
+ "type": "generated-index",
+ "description": "Manage RAGFlow with the Admin UI or RAGFlow CLI."
+ },
+ "customProps": {
+ "categoryIcon": "LucideUserCog"
+ }
+}
diff --git a/docs/administrator/admin/admin_ui/_category_.json b/docs/administrator/management/admin_ui/_category_.json
similarity index 65%
rename from docs/administrator/admin/admin_ui/_category_.json
rename to docs/administrator/management/admin_ui/_category_.json
index 342c355628..8108dee1fa 100644
--- a/docs/administrator/admin/admin_ui/_category_.json
+++ b/docs/administrator/management/admin_ui/_category_.json
@@ -1,10 +1,10 @@
{
"label": "Admin UI",
+ "position": 0,
"link": {
"type": "generated-index",
- "description": "Admin UI."
+ "description": "Manage RAGFlow in the Admin UI."
},
- "position": 1,
"customProps": {
"categoryIcon": "LucidePalette"
}
diff --git a/docs/administrator/admin/admin_ui/before_you_begin.md b/docs/administrator/management/admin_ui/before_you_begin.md
similarity index 100%
rename from docs/administrator/admin/admin_ui/before_you_begin.md
rename to docs/administrator/management/admin_ui/before_you_begin.md
diff --git a/docs/administrator/admin/admin_ui/check_system_status.md b/docs/administrator/management/admin_ui/check_system_status.md
similarity index 100%
rename from docs/administrator/admin/admin_ui/check_system_status.md
rename to docs/administrator/management/admin_ui/check_system_status.md
diff --git a/docs/administrator/admin/admin_ui/configure_code_execution_sandbox.md b/docs/administrator/management/admin_ui/configure_code_execution_sandbox.md
similarity index 79%
rename from docs/administrator/admin/admin_ui/configure_code_execution_sandbox.md
rename to docs/administrator/management/admin_ui/configure_code_execution_sandbox.md
index 5f38ad7e5a..34e1cc928c 100644
--- a/docs/administrator/admin/admin_ui/configure_code_execution_sandbox.md
+++ b/docs/administrator/management/admin_ui/configure_code_execution_sandbox.md
@@ -19,11 +19,11 @@ The page supports:
| Provider | Detailed instructions |
| --- | --- |
| **Self-Managed** | [Quickstart with Self-Managed](../../sandbox/quickstart_with_self_managed.md) |
-| **SSH** | [Configure SSH](../../sandbox/configure_ssh_and_cloud_providers.md#configure-ssh) |
-| **Aliyun Code Interpreter** | [Configure Aliyun Code Interpreter](../../sandbox/configure_ssh_and_cloud_providers.md#configure-aliyun-code-interpreter) |
-| **E2B** | [Configure E2B](../../sandbox/configure_ssh_and_cloud_providers.md#configure-e2b) |
-| **Tenki** | [Configure Tenki](../../sandbox/configure_ssh_and_cloud_providers.md#configure-tenki) |
-| **UCloud Agent Sandbox** | [Configure UCloud Agent Sandbox](../../sandbox/configure_ssh_and_cloud_providers.md#configure-ucloud-agent-sandbox) |
+| **SSH** | [Configure SSH](./configure_ssh_and_cloud_providers.md#configure-ssh) |
+| **Aliyun Code Interpreter** | [Configure Aliyun Code Interpreter](./configure_ssh_and_cloud_providers.md#configure-aliyun-code-interpreter) |
+| **E2B** | [Configure E2B](./configure_ssh_and_cloud_providers.md#configure-e2b) |
+| **Tenki** | [Configure Tenki](./configure_ssh_and_cloud_providers.md#configure-tenki) |
+| **UCloud Agent Sandbox** | [Configure UCloud Agent Sandbox](./configure_ssh_and_cloud_providers.md#configure-ucloud-agent-sandbox) |
## Test and save the configuration
diff --git a/docs/administrator/sandbox/configure_ssh_and_cloud_providers.md b/docs/administrator/management/admin_ui/configure_ssh_and_cloud_providers.md
similarity index 97%
rename from docs/administrator/sandbox/configure_ssh_and_cloud_providers.md
rename to docs/administrator/management/admin_ui/configure_ssh_and_cloud_providers.md
index 688ca5c8e6..9746d2ca07 100644
--- a/docs/administrator/sandbox/configure_ssh_and_cloud_providers.md
+++ b/docs/administrator/management/admin_ui/configure_ssh_and_cloud_providers.md
@@ -1,5 +1,5 @@
---
-sidebar_position: 3
+sidebar_position: 5
title: Configure SSH and Cloud Providers
sidebar_label: Configure SSH and Cloud Providers
slug: /configure_ssh_and_cloud_sandbox_providers
@@ -173,7 +173,7 @@ The defaults are appropriate for an initial test:
| **Max Artifacts** | `20` | Maximum number of files collected from the execution's `artifacts/` directory. |
| **Max Artifact Bytes** | `10485760` | Maximum size of one artifact file. |
-Select **Test connection**. Confirm that the result shows `PASSED`, then select **Save**. If the test returns `knownhosts: key is unknown`, see [Why does SSH return `knownhosts: key is unknown`?](./faq.md#why-does-ssh-return-knownhosts-key-is-unknown).
+Select **Test connection**. Confirm that the result shows `PASSED`, then select **Save**. If the test returns `knownhosts: key is unknown`, see [Why does SSH return `knownhosts: key is unknown`?](../../sandbox/faq.md#why-does-ssh-return-knownhosts-key-is-unknown).
## Configure Aliyun Code Interpreter
@@ -273,4 +273,4 @@ This verifies the complete path from RAGFlow to the selected provider. **Test co
When replacing a provider that is already in use, also test representative existing Agents. Confirm that their required packages, outbound network access, execution time, and artifact handling work in the new environment.
-If the test fails, see the [Code Execution Sandbox FAQ](./faq.md). For SSH, also verify the host key, authentication method, remote workspace permissions, and runtime paths. For cloud providers, verify credentials, region availability, account quota, and outbound network access from the RAGFlow server.
+If the test fails, see the [Code Execution Sandbox FAQ](../../sandbox/faq.md). For SSH, also verify the host key, authentication method, remote workspace permissions, and runtime paths. For cloud providers, verify credentials, region availability, account quota, and outbound network access from the RAGFlow server.
diff --git a/docs/administrator/admin/admin_ui/manage_user_accounts.md b/docs/administrator/management/admin_ui/manage_user_accounts.md
similarity index 100%
rename from docs/administrator/admin/admin_ui/manage_user_accounts.md
rename to docs/administrator/management/admin_ui/manage_user_accounts.md
diff --git a/docs/administrator/admin/ragflow_cli.md b/docs/administrator/management/ragflow_cli.md
similarity index 99%
rename from docs/administrator/admin/ragflow_cli.md
rename to docs/administrator/management/ragflow_cli.md
index bd614a6c38..7debba14d0 100644
--- a/docs/administrator/admin/ragflow_cli.md
+++ b/docs/administrator/management/ragflow_cli.md
@@ -1,5 +1,5 @@
---
-sidebar_position: 2
+sidebar_position: 1
title: RAGFlow CLI
sidebar_label: RAGFlow CLI
slug: /admin_cli
diff --git a/docs/administrator/migration/_category_.json b/docs/administrator/migration/_category_.json
deleted file mode 100644
index a32ac45921..0000000000
--- a/docs/administrator/migration/_category_.json
+++ /dev/null
@@ -1,8 +0,0 @@
-{
- "label": "Migration",
- "position": 2,
- "link": {
- "type": "doc",
- "id": "administrator/migration/migration_overview"
- }
-}
diff --git a/docs/administrator/monitoring/_category_.json b/docs/administrator/monitoring/_category_.json
new file mode 100644
index 0000000000..8254bacd30
--- /dev/null
+++ b/docs/administrator/monitoring/_category_.json
@@ -0,0 +1,11 @@
+{
+ "label": "Monitoring",
+ "position": 3,
+ "link": {
+ "type": "generated-index",
+ "description": "Monitor and trace RAGFlow activity."
+ },
+ "customProps": {
+ "categoryIcon": "LucideActivity"
+ }
+}
diff --git a/docs/administrator/tracing.mdx b/docs/administrator/monitoring/tracing.mdx
similarity index 99%
rename from docs/administrator/tracing.mdx
rename to docs/administrator/monitoring/tracing.mdx
index cccc3a738f..5aaf1728ca 100644
--- a/docs/administrator/tracing.mdx
+++ b/docs/administrator/monitoring/tracing.mdx
@@ -1,5 +1,5 @@
---
-sidebar_position: 5
+sidebar_position: 0
slug: /tracing
sidebar_custom_props: {
categoryIcon: LucideLocateFixed
diff --git a/docs/administrator/sandbox/_category_.json b/docs/administrator/sandbox/_category_.json
index b69ec552c8..57857d771b 100644
--- a/docs/administrator/sandbox/_category_.json
+++ b/docs/administrator/sandbox/_category_.json
@@ -1,6 +1,6 @@
{
"label": "Code Execution Sandbox",
- "position": 1,
+ "position": 2,
"link": {
"type": "doc",
"id": "administrator/sandbox/overview"
diff --git a/docs/administrator/sandbox/faq.md b/docs/administrator/sandbox/faq.md
index fe9b2e4e64..c1ab910dac 100644
--- a/docs/administrator/sandbox/faq.md
+++ b/docs/administrator/sandbox/faq.md
@@ -1,5 +1,5 @@
---
-sidebar_position: 5
+sidebar_position: 3
title: Code Execution Sandbox FAQ
sidebar_label: FAQ
slug: /sandbox_faq
@@ -129,7 +129,7 @@ The network connection reached the SSH server, but RAGFlow could not find a trus
For a non-default SSH port, the `known_hosts` entry must include the port—for example, `[192.168.1.5]:2222`. Verify the server fingerprint, add the key to the file used by RAGFlow, and ensure that the file is visible to the RAGFlow process or container.
-For Docker and source deployment instructions, see [Prepare the SSH `known_hosts` file](./configure_ssh_and_cloud_providers.md#prepare-the-ssh-known_hosts-file).
+For Docker and source deployment instructions, see [Prepare the SSH `known_hosts` file](../management/admin_ui/configure_ssh_and_cloud_providers.md#prepare-the-ssh-known_hosts-file).
If the message reports a host-key mismatch instead, verify whether the server key was intentionally changed before replacing the existing entry. An unexpected key change can indicate that the connection is being intercepted.
@@ -156,7 +156,7 @@ The configured binary must be available in the non-interactive SSH session. Shel
## Cloud providers
-Return to the detailed configuration for [Aliyun Code Interpreter](./configure_ssh_and_cloud_providers.md#configure-aliyun-code-interpreter), [E2B](./configure_ssh_and_cloud_providers.md#configure-e2b), [Tenki](./configure_ssh_and_cloud_providers.md#configure-tenki), or [UCloud Agent Sandbox](./configure_ssh_and_cloud_providers.md#configure-ucloud-agent-sandbox) when checking credentials, regions, endpoints, resource settings, or network access.
+Return to the detailed configuration for [Aliyun Code Interpreter](../management/admin_ui/configure_ssh_and_cloud_providers.md#configure-aliyun-code-interpreter), [E2B](../management/admin_ui/configure_ssh_and_cloud_providers.md#configure-e2b), [Tenki](../management/admin_ui/configure_ssh_and_cloud_providers.md#configure-tenki), or [UCloud Agent Sandbox](../management/admin_ui/configure_ssh_and_cloud_providers.md#configure-ucloud-agent-sandbox) when checking credentials, regions, endpoints, resource settings, or network access.
### Why is the API credential rejected?
diff --git a/docs/administrator/sandbox/manage_self_managed_sandbox.md b/docs/administrator/sandbox/manage_self_managed_sandbox.md
index c6466de764..fff60fcab9 100644
--- a/docs/administrator/sandbox/manage_self_managed_sandbox.md
+++ b/docs/administrator/sandbox/manage_self_managed_sandbox.md
@@ -1,5 +1,5 @@
---
-sidebar_position: 4
+sidebar_position: 2
title: Manage Self-Managed Sandbox
sidebar_label: Manage Self-Managed Sandbox
slug: /manage_self_managed_sandbox
@@ -213,4 +213,4 @@ The Compose service accepts one configured token. Requests can fail between rest
Admin controls the RAGFlow-to-Manager connection: endpoint, API token, and request timeout. Compose variables control the Manager and Runner deployment. Changing one does not automatically update the other.
-For the connection fields, see [Configure Code Execution Sandbox](../admin/admin_ui/configure_code_execution_sandbox.md#self-managed-fields).
+For the connection fields, see [Configure Code Execution Sandbox](../management/admin_ui/configure_code_execution_sandbox.md#self-managed-fields).
diff --git a/docs/administrator/sandbox/overview.md b/docs/administrator/sandbox/overview.md
index e3e3f0acbb..4c472fefa0 100644
--- a/docs/administrator/sandbox/overview.md
+++ b/docs/administrator/sandbox/overview.md
@@ -1,5 +1,5 @@
---
-sidebar_position: 1
+sidebar_position: 0
title: Code Execution Sandbox
sidebar_label: Overview
slug: /code_execution_sandbox
@@ -24,11 +24,11 @@ Choose the provider that matches where you want code to run and who should manag
| Provider | Where code runs | Choose it when |
| --- | --- | --- |
| [**Self-Managed**](./quickstart_with_self_managed.md) | Python or Node.js Runner containers managed by Sandbox Executor Manager in your environment | You want to keep code execution under your operational control. This is the default option and the focus of the Self-Managed guides. |
-| [**SSH**](./configure_ssh_and_cloud_providers.md#configure-ssh) | An existing remote Linux host | You already operate a suitable execution server with Python or Node.js and can manage its SSH access and host keys. |
-| [**Aliyun Code Interpreter**](./configure_ssh_and_cloud_providers.md#configure-aliyun-code-interpreter) | Alibaba Cloud Code Interpreter | Your organization uses Alibaba Cloud and wants a managed execution environment. |
-| [**E2B**](./configure_ssh_and_cloud_providers.md#configure-e2b) | E2B cloud sandboxes | You want an externally managed cloud sandbox without operating local Runner containers. |
-| [**Tenki**](./configure_ssh_and_cloud_providers.md#configure-tenki) | A disposable Tenki microVM created for each execution | You want each run to use an isolated, short-lived cloud microVM. |
-| [**UCloud Agent Sandbox**](./configure_ssh_and_cloud_providers.md#configure-ucloud-agent-sandbox) | A disposable UCloud Agent Sandbox | You want a managed cloud sandbox in a supported UCloud region. |
+| [**SSH**](../management/admin_ui/configure_ssh_and_cloud_providers.md#configure-ssh) | An existing remote Linux host | You already operate a suitable execution server with Python or Node.js and can manage its SSH access and host keys. |
+| [**Aliyun Code Interpreter**](../management/admin_ui/configure_ssh_and_cloud_providers.md#configure-aliyun-code-interpreter) | Alibaba Cloud Code Interpreter | Your organization uses Alibaba Cloud and wants a managed execution environment. |
+| [**E2B**](../management/admin_ui/configure_ssh_and_cloud_providers.md#configure-e2b) | E2B cloud sandboxes | You want an externally managed cloud sandbox without operating local Runner containers. |
+| [**Tenki**](../management/admin_ui/configure_ssh_and_cloud_providers.md#configure-tenki) | A disposable Tenki microVM created for each execution | You want each run to use an isolated, short-lived cloud microVM. |
+| [**UCloud Agent Sandbox**](../management/admin_ui/configure_ssh_and_cloud_providers.md#configure-ucloud-agent-sandbox) | A disposable UCloud Agent Sandbox | You want a managed cloud sandbox in a supported UCloud region. |
:::note Before choosing a cloud provider
Confirm that your RAGFlow deployment can reach the provider's API, and that your account has valid credentials, sufficient quota, and access to the required region.
@@ -47,5 +47,5 @@ RAGFlow can run with Docker Compose or directly from source while Sandbox Execut
## Next steps
- Get started with [Quickstart with Self-Managed](./quickstart_with_self_managed.md).
-- To use SSH or a cloud service, see [Configure SSH and Cloud Providers](./configure_ssh_and_cloud_providers.md).
+- To use SSH or a cloud service, see [Configure SSH and Cloud Providers](../management/admin_ui/configure_ssh_and_cloud_providers.md).
- For maintenance and troubleshooting, see [Manage Self-Managed Sandbox](./manage_self_managed_sandbox.md) and [FAQ](./faq.md).
diff --git a/docs/administrator/sandbox/quickstart_with_self_managed.md b/docs/administrator/sandbox/quickstart_with_self_managed.md
index a9e9526655..78a3f8ffa3 100644
--- a/docs/administrator/sandbox/quickstart_with_self_managed.md
+++ b/docs/administrator/sandbox/quickstart_with_self_managed.md
@@ -1,5 +1,5 @@
---
-sidebar_position: 2
+sidebar_position: 1
title: Quickstart with Self-Managed
sidebar_label: Quickstart with Self-Managed
slug: /sandbox_quickstart_self_managed
@@ -199,4 +199,4 @@ The setup is complete when:
- To adjust Runner capacity, images, resource limits, network access, artifacts, or authentication, see [Manage Self-Managed Sandbox](./manage_self_managed_sandbox.md).
- To connect RAGFlow to an Executor Manager on another host, see [Connect to a remote Executor Manager](./manage_self_managed_sandbox.md#connect-to-a-remote-executor-manager).
- If startup, connection, authentication, or execution fails, see [Code Execution Sandbox FAQ](./faq.md).
-- To use SSH or a managed cloud service instead, see [Configure SSH and Cloud Providers](./configure_ssh_and_cloud_providers.md).
+- To use SSH or a managed cloud service instead, see [Configure SSH and Cloud Providers](../management/admin_ui/configure_ssh_and_cloud_providers.md).
diff --git a/docs/administrator/setup/_category_.json b/docs/administrator/setup/_category_.json
new file mode 100644
index 0000000000..1758e5c0a8
--- /dev/null
+++ b/docs/administrator/setup/_category_.json
@@ -0,0 +1,11 @@
+{
+ "label": "Admin Setup",
+ "position": 0,
+ "link": {
+ "type": "generated-index",
+ "description": "Configure RAGFlow and set up the Admin Service."
+ },
+ "customProps": {
+ "categoryIcon": "LucideSettings"
+ }
+}
diff --git a/docs/administrator/admin/admin_service.md b/docs/administrator/setup/admin_service.md
similarity index 99%
rename from docs/administrator/admin/admin_service.md
rename to docs/administrator/setup/admin_service.md
index c5755a034b..f565966e3b 100644
--- a/docs/administrator/admin/admin_service.md
+++ b/docs/administrator/setup/admin_service.md
@@ -1,5 +1,5 @@
---
-sidebar_position: 0
+sidebar_position: 2
title: Admin Service
sidebar_label: Admin Service
slug: /admin_service
diff --git a/docs/administrator/configurations/configurations.md b/docs/administrator/setup/configuration.md
similarity index 99%
rename from docs/administrator/configurations/configurations.md
rename to docs/administrator/setup/configuration.md
index 520f08737e..83bbaec3e5 100644
--- a/docs/administrator/configurations/configurations.md
+++ b/docs/administrator/setup/configuration.md
@@ -201,7 +201,7 @@ s3:
- `region_name`: Must be `auto`.
- `endpoint_url`: `https://t3.storage.dev`, or `https://fly.storage.tigris.dev` on Fly.io.
- `addressing_style`: Must be `virtual`.
-- `bucket` / `prefix_path`: Optional. Enables single-bucket mode. Before changing the storage layout, create a recovery point by following [Backup and Restore (v1.x)](../migration/backup_and_restore_v1.md).
+- `bucket` / `prefix_path`: Optional. Enables single-bucket mode. Before changing the storage layout, create a recovery point by following [Backup and Restore (v1.x)](../upgrade_and_migration/backup_and_restore_v1.md).
When using an external storage backend, you can remove the `minio` service from `docker-compose-base.yml`.
diff --git a/docs/administrator/configurations/config_ssl_cert.md b/docs/administrator/setup/configure_ssl_certificates.md
similarity index 100%
rename from docs/administrator/configurations/config_ssl_cert.md
rename to docs/administrator/setup/configure_ssl_certificates.md
diff --git a/docs/administrator/upgrade_and_migration/_category_.json b/docs/administrator/upgrade_and_migration/_category_.json
new file mode 100644
index 0000000000..bd55c37c17
--- /dev/null
+++ b/docs/administrator/upgrade_and_migration/_category_.json
@@ -0,0 +1,11 @@
+{
+ "label": "Upgrade and Migration",
+ "position": 4,
+ "link": {
+ "type": "doc",
+ "id": "administrator/upgrade_and_migration/start_here"
+ },
+ "customProps": {
+ "categoryIcon": "LucideArrowBigUpDash"
+ }
+}
diff --git a/docs/administrator/migration/backup_and_restore_v0.md b/docs/administrator/upgrade_and_migration/backup_and_restore_v0.md
similarity index 99%
rename from docs/administrator/migration/backup_and_restore_v0.md
rename to docs/administrator/upgrade_and_migration/backup_and_restore_v0.md
index 1d5849f807..13dcdf7520 100644
--- a/docs/administrator/migration/backup_and_restore_v0.md
+++ b/docs/administrator/upgrade_and_migration/backup_and_restore_v0.md
@@ -1,5 +1,5 @@
---
-sidebar_position: 2
+sidebar_position: 4
title: Backup and Restore (v0.x)
sidebar_label: Backup and Restore (v0.x)
slug: /backup_and_restore_v0
diff --git a/docs/administrator/migration/backup_and_restore_v1.md b/docs/administrator/upgrade_and_migration/backup_and_restore_v1.md
similarity index 99%
rename from docs/administrator/migration/backup_and_restore_v1.md
rename to docs/administrator/upgrade_and_migration/backup_and_restore_v1.md
index 04aabc11fe..fc415574bd 100644
--- a/docs/administrator/migration/backup_and_restore_v1.md
+++ b/docs/administrator/upgrade_and_migration/backup_and_restore_v1.md
@@ -1,5 +1,5 @@
---
-sidebar_position: 3
+sidebar_position: 2
title: "Backup and Restore (v1.x)"
sidebar_label: "Backup and Restore (v1.x)"
slug: /backup_and_restore_v1
diff --git a/docs/administrator/migration/database_change_log.md b/docs/administrator/upgrade_and_migration/database_change_log.md
similarity index 99%
rename from docs/administrator/migration/database_change_log.md
rename to docs/administrator/upgrade_and_migration/database_change_log.md
index f0fe58a993..89a06678d4 100644
--- a/docs/administrator/migration/database_change_log.md
+++ b/docs/administrator/upgrade_and_migration/database_change_log.md
@@ -1,5 +1,5 @@
---
-sidebar_position: 3
+sidebar_position: 6
title: Database Change Log
sidebar_label: Database Change Log
slug: /database_change_log
diff --git a/docs/administrator/migration/migration_overview.md b/docs/administrator/upgrade_and_migration/start_here.md
similarity index 100%
rename from docs/administrator/migration/migration_overview.md
rename to docs/administrator/upgrade_and_migration/start_here.md
diff --git a/docs/administrator/migration/upgrade_from_v0_to_v1.md b/docs/administrator/upgrade_and_migration/upgrade_from_v0_to_v1.md
similarity index 99%
rename from docs/administrator/migration/upgrade_from_v0_to_v1.md
rename to docs/administrator/upgrade_and_migration/upgrade_from_v0_to_v1.md
index 763f042ce9..8f40055a83 100644
--- a/docs/administrator/migration/upgrade_from_v0_to_v1.md
+++ b/docs/administrator/upgrade_and_migration/upgrade_from_v0_to_v1.md
@@ -1,5 +1,5 @@
---
-sidebar_position: 1
+sidebar_position: 5
title: Upgrade from v0.x to v1.x
sidebar_label: Upgrade from v0.x to v1.x
slug: /upgrade_from_v0_to_v1
@@ -12,7 +12,7 @@ sidebar_custom_props: {
This guide provides the step-by-step procedure for upgrading a MySQL-based Docker deployment from RAGFlow `v0.20.0` or later to the current latest version.
-Before continuing, review the standard route in [Migration Guide](./migration_overview.md) and complete the backup and preparation checklist.
+Before continuing, review the standard route in [Migration Guide](./start_here.md) and complete the backup and preparation checklist.
:::danger Do not skip the v0.x to v1.x boundary
Every `v0.x` deployment must successfully start and pass verification on `v0.27.2`, and must then be upgraded to `v1.0.0-rc1`. Do not upgrade directly from an earlier `v0.x` release to `v1.0.0-rc1` or a later `v1.x` release.
diff --git a/docs/administrator/migration/upgrade_from_v1_to_later_releases.md b/docs/administrator/upgrade_and_migration/upgrade_from_v1_to_later_releases.md
similarity index 99%
rename from docs/administrator/migration/upgrade_from_v1_to_later_releases.md
rename to docs/administrator/upgrade_and_migration/upgrade_from_v1_to_later_releases.md
index c135e0793c..8d791d1f8b 100644
--- a/docs/administrator/migration/upgrade_from_v1_to_later_releases.md
+++ b/docs/administrator/upgrade_and_migration/upgrade_from_v1_to_later_releases.md
@@ -1,5 +1,5 @@
---
-sidebar_position: 4
+sidebar_position: 3
title: Upgrade from v1.x to later releases
sidebar_label: Upgrade from v1.x to later releases
slug: /upgrade_from_v1_to_later_releases
diff --git a/docs/administrator/upgrade_ragflow.mdx b/docs/administrator/upgrade_and_migration/upgrading.mdx
similarity index 100%
rename from docs/administrator/upgrade_ragflow.mdx
rename to docs/administrator/upgrade_and_migration/upgrading.mdx
diff --git a/docs/release_notes.md b/docs/release_notes.md
index 4ab2d33c3b..6e8772f39f 100644
--- a/docs/release_notes.md
+++ b/docs/release_notes.md
@@ -1263,7 +1263,7 @@ From this release onwards, **service_config.yaml.template** replaces **service_c
This approach eliminates the need to manually update **service_config.yaml** after making changes to **.env**, facilitating dynamic environment configurations.
:::danger IMPORTANT
-Ensure that you [upgrade **both** your code **and** Docker image to this release](./administrator/upgrade_ragflow.mdx#upgrade-ragflow-to-given-release) before trying this new approach.
+Ensure that you [upgrade **both** your code **and** Docker image to this release](./administrator/upgrade_and_migration/upgrading.mdx#upgrade-ragflow-to-given-release) before trying this new approach.
:::
### API changes
@@ -1341,13 +1341,13 @@ The default Docker image edition is `nightly-slim`. The following list clarifies
- `nightly`: The full edition of the most recent tested Docker image.
- `v0.12.0`: The full edition of the most recent **officially released** Docker image.
-See [Upgrade RAGFlow](./administrator/upgrade_ragflow.mdx) for instructions on upgrading.
+See [Upgrade RAGFlow](./administrator/upgrade_and_migration/upgrading.mdx) for instructions on upgrading.
### Documentation
#### Added documents
-- [Upgrade RAGFlow](./administrator/upgrade_ragflow.mdx)
+- [Upgrade RAGFlow](./administrator/upgrade_and_migration/upgrading.mdx)
## v0.11.0