Skip to content

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

docs: run migrations before starting Go servers (#19776)

adwsf69e33559c8f
diff --git a/internal/development.md b/internal/development.md
index a618ea8436..a96ebd0eef 100644
--- a/internal/development.md
+++ b/internal/development.md
@@ -203,18 +203,14 @@ docker compose -f docker/docker-compose-base.yml --profile ragflow-go --profile
- Start RAGFlow
-Note: admin server must be started first; otherwise, api server will encounter errors when sending heartbeats.
-
-```bash
-# Start admin server
-./bin/ragflow_server --admin
-```
+Note: Database migrations must complete before starting any server mode.
+After migration, start the admin server before the API and ingestor servers;
+otherwise, they will encounter errors when sending heartbeats.
```bash
# Run database migrations (standalone action; does not start a server)
./bin/ragflow_server --migrate
```
-
`--migrate` writes the database version marker that server modes check on
startup, and a development branch regularly records a version for a release
that has not been tagged yet — a build from a `v0.27.x` commit that writes
@@ -223,6 +219,14 @@ looks newer than the code. Set `RAGFLOW_DEV_MODE=true` (see `docker/.env`) for
such a checkout: it turns the "code version must not be older than the database
version" guard off. Leave it off in production.
+
+```bash
+# Start admin server
+./bin/ragflow_server --admin
+```
+
+
+
```bash
# Start RAGFlow server
./bin/ragflow_server --api