RAGFlow is an agent-native database: a Retrieval-Augmented Generation (RAG) engine that grew into context infrastructure.
Go agent-harnessagent-native-databaseagentic-aiagentic-retrievalagentic-searchaiai-agentscontext-enginecontext-engineeringcontext-managementharness-engineeringknowledge-compilationragretrieval-augmented-generationretrieval-harnesssearch-harness
docs: mark macOS as temporarily unsupported for the Go backend (#20642)
xugangqiangd05e8c317fed
diff --git a/README.md b/README.mdindex 694cd3465f..5a0f2699f2 100644--- a/README.md+++ b/README.md@@ -238,7 +238,7 @@ Docker deployment does not require Go on the host. Self-Managed container Sandbo#### ⚙️ Docker Configuration and Adjustment-Go Docker deployment uses `docker/.env` and `docker/docker-compose.yml`, uses Kvrocks for cache and Checkpoint storage, and uses NATS JetStream as the message queue. Configure the image, ports, passwords, document engine, and model image source as described in the [Docker configuration guide](./docker/README.md). For platform limitations and macOS requirements, see the [Go Docker image build and platform support guide](./docs/develop/build_docker_image.mdx).+Go Docker deployment uses `docker/.env` and `docker/docker-compose.yml`, uses Kvrocks for cache and Checkpoint storage, and uses NATS JetStream as the message queue. Configure the image, ports, passwords, document engine, and model image source as described in the [Docker configuration guide](./docker/README.md). macOS is temporarily not supported by the Go backend (use a Linux x86_64 host); for platform support details, see the [Go Docker image build guide](./docs/develop/build_docker_image.mdx).For document-engine changes, configuration updates, restarting services, and retaining or removing existing data, follow the Docker configuration guide.diff --git a/README_ar.md b/README_ar.mdindex 4155e49b1f..9c98af79f3 100644--- a/README_ar.md+++ b/README_ar.md@@ -262,7 +262,7 @@#### ⚙️ إعداد Docker وتعديله-يستخدم نشر Go عبر Docker الملفين `docker/.env` و`docker/docker-compose.yml`، ويستخدم Kvrocks لتخزين ذاكرة التخزين المؤقت ونقاط التحقق، كما يستخدم NATS JetStream كقائمة انتظار للرسائل. لتعديل الصورة والمنافذ وكلمات المرور ومحرك المستندات ومصدر صور النماذج، اتبع [دليل إعداد Docker](./docker/README.md). ولقيود المنصات ومتطلبات macOS، راجع [دليل بناء صورة Go ودعم المنصات](./docs/develop/build_docker_image.mdx).+يستخدم نشر Go عبر Docker الملفين `docker/.env` و`docker/docker-compose.yml`، ويستخدم Kvrocks لتخزين ذاكرة التخزين المؤقت ونقاط التحقق، كما يستخدم NATS JetStream كقائمة انتظار للرسائل. لتعديل الصورة والمنافذ وكلمات المرور ومحرك المستندات ومصدر صور النماذج، اتبع [دليل إعداد Docker](./docker/README.md). ودعم المنصات (ملاحظة: نظام macOS غير مدعوم مؤقتًا، استخدم مضيف Linux x86_64)، راجع [دليل بناء صورة Go ودعم المنصات](./docs/develop/build_docker_image.mdx).عند تبديل محرك المستندات أو تعديل الإعدادات وإعادة تشغيل الخدمات أو الاحتفاظ بالبيانات الحالية أو حذفها، اتبع أيضًا دليل إعداد Docker أعلاه.diff --git a/README_fr.md b/README_fr.mdindex f8f6b2fae1..5900e3c7db 100644--- a/README_fr.md+++ b/README_fr.md@@ -250,7 +250,7 @@ Le déploiement Docker ne nécessite pas l’installation de Go sur l’hôte. L#### ⚙️ Configuration et ajustement de Docker-Le déploiement Docker Go utilise `docker/.env` et `docker/docker-compose.yml`, Kvrocks pour le cache et le stockage des Checkpoints, et NATS JetStream comme file de messages. Pour configurer l’image, les ports, les mots de passe, le moteur de documents et la source des images de modèles, consultez le [guide de configuration Docker](./docker/README.md). Pour les limites de plateforme et les exigences macOS, consultez le [guide de construction de l’image Go et de prise en charge des plateformes](./docs/develop/build_docker_image.mdx).+Le déploiement Docker Go utilise `docker/.env` et `docker/docker-compose.yml`, Kvrocks pour le cache et le stockage des Checkpoints, et NATS JetStream comme file de messages. Pour configurer l’image, les ports, les mots de passe, le moteur de documents et la source des images de modèles, consultez le [guide de configuration Docker](./docker/README.md). Pour la prise en charge des plateformes (note : macOS n'est temporairement pas pris en charge, utilisez un hôte Linux x86_64), consultez le [guide de construction de l’image Go et de prise en charge des plateformes](./docs/develop/build_docker_image.mdx).Pour changer de moteur de documents, modifier la configuration, redémarrer les services ou conserver/supprimer les données existantes, suivez également le guide de configuration Docker ci-dessus.diff --git a/README_id.md b/README_id.mdindex de3d5c93e5..a5387d30da 100644--- a/README_id.md+++ b/README_id.md@@ -258,7 +258,7 @@ Deployment Docker tidak memerlukan Go di host. Container Sandbox Self-Managed me#### ⚙️ Konfigurasi dan Penyesuaian Docker-Deployment Docker Go menggunakan `docker/.env` dan `docker/docker-compose.yml`, dengan Kvrocks untuk cache dan penyimpanan Checkpoint serta NATS JetStream sebagai antrean pesan. Untuk mengatur image, port, kata sandi, mesin dokumen, dan sumber image model, lihat [panduan konfigurasi Docker](./docker/README.md). Untuk batasan platform dan persyaratan macOS, lihat [panduan build image Go dan dukungan platform](./docs/develop/build_docker_image.mdx).+Deployment Docker Go menggunakan `docker/.env` dan `docker/docker-compose.yml`, dengan Kvrocks untuk cache dan penyimpanan Checkpoint serta NATS JetStream sebagai antrean pesan. Untuk mengatur image, port, kata sandi, mesin dokumen, dan sumber image model, lihat [panduan konfigurasi Docker](./docker/README.md). Untuk dukungan platform (catatan: macOS sementara tidak didukung, gunakan host Linux x86_64), lihat [panduan build image Go dan dukungan platform](./docs/develop/build_docker_image.mdx).Untuk mengganti mesin dokumen, mengubah konfigurasi, memulai ulang layanan, serta mempertahankan atau menghapus data yang ada, ikuti juga panduan konfigurasi Docker tersebut.diff --git a/README_ja.md b/README_ja.mdindex 2e8b71808e..a1ae328d0f 100644--- a/README_ja.md+++ b/README_ja.md@@ -240,7 +240,7 @@ DockerデプロイではホストへのGoのインストールは不要です。#### ⚙️ Docker の設定と調整-Go版のDockerデプロイでは `docker/.env` と `docker/docker-compose.yml` を使用し、キャッシュとCheckpointの保存にKvrocks、メッセージキューにNATS JetStreamを使用します。イメージ、ポート、パスワード、ドキュメントエンジン、モデルイメージの取得元を変更する場合は、[Docker設定ガイド](./docker/README.md)に従ってください。プラットフォームの制限とmacOSの要件については、[Go Dockerイメージのビルドとプラットフォームサポートガイド](./docs/develop/build_docker_image.mdx)を参照してください。+Go版のDockerデプロイでは `docker/.env` と `docker/docker-compose.yml` を使用し、キャッシュとCheckpointの保存にKvrocks、メッセージキューにNATS JetStreamを使用します。イメージ、ポート、パスワード、ドキュメントエンジン、モデルイメージの取得元を変更する場合は、[Docker設定ガイド](./docker/README.md)に従ってください。プラットフォームのサポートについて(注:macOSは現時点では非対応です。Linux x86_64ホストを使用してください)、[Go Dockerイメージのビルドとプラットフォームサポートガイド](./docs/develop/build_docker_image.mdx)を参照してください。ドキュメントエンジンの切り替え、設定変更後のサービス再起動、既存データの保持または削除についても、上記のDocker設定ガイドに従ってください。diff --git a/README_ko.md b/README_ko.mdindex 122403ba4c..fa22b04274 100644--- a/README_ko.md+++ b/README_ko.md@@ -239,7 +239,7 @@ Docker 배포에는 호스트에 Go를 설치할 필요가 없습니다. Self-Ma#### ⚙️ Docker 구성 및 조정-Go Docker 배포는 `docker/.env`와 `docker/docker-compose.yml`을 사용하며, 캐시와 Checkpoint 저장에는 Kvrocks를, 메시지 큐에는 NATS JetStream을 사용합니다. 이미지, 포트, 비밀번호, 문서 엔진, 모델 이미지 소스를 변경하려면 [Docker 구성 가이드](./docker/README.md)를 따르세요. 플랫폼 제한과 macOS 요구 사항은 [Go Docker 이미지 빌드 및 플랫폼 지원 가이드](./docs/develop/build_docker_image.mdx)를 참조하세요.+Go Docker 배포는 `docker/.env`와 `docker/docker-compose.yml`을 사용하며, 캐시와 Checkpoint 저장에는 Kvrocks를, 메시지 큐에는 NATS JetStream을 사용합니다. 이미지, 포트, 비밀번호, 문서 엔진, 모델 이미지 소스를 변경하려면 [Docker 구성 가이드](./docker/README.md)를 따르세요. 플랫폼 지원(참고: macOS는 현재 지원되지 않음, Linux x86_64 호스트 사용 권장)은 [Go Docker 이미지 빌드 및 플랫폼 지원 가이드](./docs/develop/build_docker_image.mdx)를 참조하세요.문서 엔진 전환, 구성 변경 후 서비스 재시작, 기존 데이터 보존 또는 삭제 작업도 위 Docker 구성 가이드를 따르세요.diff --git a/README_pt_br.md b/README_pt_br.mdindex ad017d5ae3..9de7e3528a 100644--- a/README_pt_br.md+++ b/README_pt_br.md@@ -246,7 +246,7 @@ _O show está no ar!_#### ⚙️ Configuração e ajustes do Docker-A implantação Go com Docker usa `docker/.env` e `docker/docker-compose.yml`, com Kvrocks para cache e armazenamento de Checkpoints e NATS JetStream como fila de mensagens. Para configurar imagem, portas, senhas, mecanismo de documentos e origem das imagens de modelos, consulte o [guia de configuração do Docker](./docker/README.md). Para limitações de plataforma e requisitos do macOS, consulte o [guia de build da imagem Go e suporte a plataformas](./docs/develop/build_docker_image.mdx).+A implantação Go com Docker usa `docker/.env` e `docker/docker-compose.yml`, com Kvrocks para cache e armazenamento de Checkpoints e NATS JetStream como fila de mensagens. Para configurar imagem, portas, senhas, mecanismo de documentos e origem das imagens de modelos, consulte o [guia de configuração do Docker](./docker/README.md). Para suporte de plataforma (observação: macOS não é suportado temporariamente, use um host Linux x86_64), consulte o [guia de build da imagem Go e suporte a plataformas](./docs/develop/build_docker_image.mdx).Para trocar o mecanismo de documentos, alterar configurações, reiniciar serviços e manter ou remover dados existentes, siga também o guia de configuração do Docker.diff --git a/README_ru.md b/README_ru.mdindex fd3b7371e3..9716a42e21 100644--- a/README_ru.md+++ b/README_ru.md@@ -255,7 +255,7 @@#### ⚙️ Настройка Docker-Развёртывание Go в Docker использует `docker/.env` и `docker/docker-compose.yml`, Kvrocks для кэша и хранения Checkpoint, а NATS JetStream — в качестве очереди сообщений. Изменяйте образ, порты, пароли, движок документов и источник образов моделей в соответствии с [руководством по настройке Docker](./docker/README.md). Ограничения платформ и требования macOS описаны в [руководстве по сборке Go-образа и поддержке платформ](./docs/develop/build_docker_image.mdx).+Развёртывание Go в Docker использует `docker/.env` и `docker/docker-compose.yml`, Kvrocks для кэша и хранения Checkpoint, а NATS JetStream — в качестве очереди сообщений. Изменяйте образ, порты, пароли, движок документов и источник образов моделей в соответствии с [руководством по настройке Docker](./docker/README.md). Поддержка платформ (примечание: macOS временно не поддерживается, используйте хост Linux x86_64) описана в [руководстве по сборке Go-образа и поддержке платформ](./docs/develop/build_docker_image.mdx).При смене движка документов, изменении конфигурации и перезапуске сервисов, а также при сохранении или удалении существующих данных следуйте этому же руководству по настройке Docker.diff --git a/README_tr.md b/README_tr.mdindex bbb20b8fd4..f088e8094d 100644--- a/README_tr.md+++ b/README_tr.md@@ -258,7 +258,7 @@ Docker dağıtımı ana makineye Go kurulmasını gerektirmez. Self-Managed kaps#### ⚙️ Docker Yapılandırması ve Ayarlama-Go Docker dağıtımı `docker/.env` ve `docker/docker-compose.yml` dosyalarını kullanır; önbellek ve Checkpoint depolaması için Kvrocks, mesaj kuyruğu olarak da NATS JetStream kullanılır. İmajı, bağlantı noktalarını, parolaları, belge motorunu ve model imajı kaynağını değiştirmek için [Docker yapılandırma kılavuzunu](./docker/README.md) izleyin. Platform sınırlamaları ve macOS gereksinimleri için [Go Docker imajı oluşturma ve platform desteği kılavuzuna](./docs/develop/build_docker_image.mdx) bakın.+Go Docker dağıtımı `docker/.env` ve `docker/docker-compose.yml` dosyalarını kullanır; önbellek ve Checkpoint depolaması için Kvrocks, mesaj kuyruğu olarak da NATS JetStream kullanılır. İmajı, bağlantı noktalarını, parolaları, belge motorunu ve model imajı kaynağını değiştirmek için [Docker yapılandırma kılavuzunu](./docker/README.md) izleyin. Platform desteği (not: macOS geçici olarak desteklenmiyor, Linux x86_64 ana makinesi kullanın) için [Go Docker imajı oluşturma ve platform desteği kılavuzuna](./docs/develop/build_docker_image.mdx) bakın.Belge motorunu değiştirme, yapılandırma değişikliklerinden sonra hizmetleri yeniden başlatma ve mevcut verileri koruma veya temizleme işlemleri için de yukarıdaki Docker yapılandırma kılavuzunu izleyin.diff --git a/README_tzh.md b/README_tzh.mdindex b6e2ff903b..54160bfb5d 100644--- a/README_tzh.md+++ b/README_tzh.md@@ -209,7 +209,7 @@ Docker 部署無需在主機安裝 Go。使用 Self-Managed 容器 Sandbox 時3. 切換至 Go 版發布標籤,並使用 Docker Compose 啟動伺服器:> [!NOTE]-> Go 映像的正式建置目標為 `linux/amd64`。平台限制和 macOS 要求請參閱[Go Docker 映像建置與平台支援指南](./docs/develop/build_docker_image.mdx)。+> Go 映像的正式建置目標為 `linux/amd64`。平台支援(注意:macOS 暫不受 Go 後端支援,請使用 Linux x86_64 主機)請參閱[Go Docker 映像建置與平台支援指南](./docs/develop/build_docker_image.mdx)。進入 Docker 部署目錄。@@ -256,7 +256,7 @@ Docker 部署無需在主機安裝 Go。使用 Self-Managed 容器 Sandbox 時#### ⚙️ Docker 設定與調整-Go 版 Docker 部署使用 `docker/.env` 和 `docker/docker-compose.yml`,以 Kvrocks 儲存快取和 Checkpoint,並使用 NATS JetStream 作為訊息佇列。映像、連接埠、密碼、文件引擎和模型映像來源,請參閱 [Docker 設定說明](./docker/README.md)。平台限制和 macOS 執行要求,請參閱 [Go Docker 映像建置與平台支援指南](./docs/develop/build_docker_image.mdx)。+Go 版 Docker 部署使用 `docker/.env` 和 `docker/docker-compose.yml`,以 Kvrocks 儲存快取和 Checkpoint,並使用 NATS JetStream 作為訊息佇列。映像、連接埠、密碼、文件引擎和模型映像來源,請參閱 [Docker 設定說明](./docker/README.md)。平台支援(注意:macOS 暫不受支援),請參閱 [Go Docker 映像建置與平台支援指南](./docs/develop/build_docker_image.mdx)。切換文件引擎、更新設定、重新啟動服務,以及保留或清除既有資料等操作,也請依照上述 Docker 設定文件執行。diff --git a/README_zh.md b/README_zh.mdindex abc0bf0ba9..8640e737bd 100644--- a/README_zh.md+++ b/README_zh.md@@ -205,7 +205,7 @@ Docker 部署无需在宿主机安装 Go。使用 Self-Managed 容器 Sandbox3. 切换到 Go 版发布标签并使用 Docker Compose 启动服务器:- > ⚠️ **提示:** `v1.0.0-rc1` 及之后的发布标签使用 Go 实现。详细平台和 macOS 要求请参阅[Go Docker 镜像构建与平台支持说明](./docs/develop/build_docker_image.mdx)。+ > ⚠️ **提示:** `v1.0.0-rc1` 及之后的发布标签使用 Go 实现。平台支持说明(注意:macOS 暂不受 Go 后端支持,请使用 Linux x86_64 主机)请参阅[Go Docker 镜像构建指南](./docs/develop/build_docker_image.mdx)。进入仓库中的 Docker 部署目录。@@ -262,7 +262,7 @@ Docker 部署无需在宿主机安装 Go。使用 Self-Managed 容器 Sandbox#### ⚙️ Docker 配置与调整-Go 版 Docker 部署使用 `docker/.env` 和 `docker/docker-compose.yml`,使用 Kvrocks 存储缓存和 Checkpoint,并使用 NATS JetStream 作为消息队列。镜像、端口、密码、文档引擎及模型镜像源请按[Docker 配置说明](./docker/README.md)修改;平台限制和 macOS 运行要求请参阅[Go Docker 镜像构建与平台支持指南](./docs/develop/build_docker_image.mdx)。源码构建 Docker 镜像请参阅[Go Docker 镜像构建与平台支持指南](./docs/develop/build_docker_image.mdx)。+Go 版 Docker 部署使用 `docker/.env` 和 `docker/docker-compose.yml`,使用 Kvrocks 存储缓存和 Checkpoint,并使用 NATS JetStream 作为消息队列。镜像、端口、密码、文档引擎及模型镜像源请按[Docker 配置说明](./docker/README.md)修改;平台支持(注意:macOS 暂不受支持)请参阅[Go Docker 镜像构建与平台支持指南](./docs/develop/build_docker_image.mdx)。源码构建 Docker 镜像请参阅[Go Docker 镜像构建与平台支持指南](./docs/develop/build_docker_image.mdx)。切换文档引擎、修改配置后重启服务,以及保留或清理已有数据的操作,也请按照上述 Docker 配置文档执行。diff --git a/docker/README.md b/docker/README.mdindex 7528856d6c..77286dae1b 100644--- a/docker/README.md+++ b/docker/README.md@@ -21,7 +21,7 @@ The Go image runs the API, Admin, Ingestor, and Syncer modes from the single `bi- **docker-compose-base.yml**Defines the dependency services. The default Go profile uses Elasticsearch, MySQL, MinIO, Kvrocks, NATS, and ClickHouse. Other document engines and metadata databases are selected through `.env`.-> **Note:** `docker-compose-CN-oc9.yml` and `docker-compose-macos.yml` are not the Go deployment entry points. On Linux and macOS, use `docker-compose.yml`; Apple Silicon runs the current `linux/amd64` Go image through Docker Desktop emulation.+> **Note:** `docker-compose-CN-oc9.yml` and `docker-compose-macos.yml` are not the Go deployment entry points. Use `docker-compose.yml` on a Linux x86-64 host; macOS is temporarily not supported by the Go backend.### Quick start@@ -42,7 +42,7 @@ If you use the default Elasticsearch document engine on Linux, set `vm.max_map_csudo sysctl -w vm.max_map_count=262144```-This change is temporary. To preserve it after a reboot, add `vm.max_map_count=262144` to `/etc/sysctl.conf`. On Docker Desktop, apply the setting inside its Linux virtual machine as described in the [Go image build guide](../docs/develop/build_docker_image.mdx#macos-with-docker-desktop).+This change is temporary. To preserve it after a reboot, add `vm.max_map_count=262144` to `/etc/sysctl.conf`.The `v1.0.0-rc1` tag and later release tags use the Go implementation. The entrypoint migrates the default MySQL metadata database first, then starts the Go Syncer, Admin server, API server, and Ingestor. Open `http://localhost` after the HTTP health check succeeds.diff --git a/docs/administrator/configurations/configurations.md b/docs/administrator/configurations/configurations.mdindex 552ef93a1e..f7f62960fd 100644--- a/docs/administrator/configurations/configurations.md+++ b/docs/administrator/configurations/configurations.md@@ -149,11 +149,6 @@ If you cannot download the RAGFlow Docker image, try the following mirrors.- `HF_ENDPOINT`The mirror site for huggingface.co. It is disabled by default. You can uncomment this line if you have limited access to the primary Hugging Face domain.-### macOS--- `MACOS`- Optimizations for macOS. It is disabled by default. You can uncomment this line if your OS is macOS.-### User Registration- `ENABLE_REGISTER`diff --git a/docs/develop/build_docker_image.mdx b/docs/develop/build_docker_image.mdxindex aff6c27387..58718ca0e0 100644--- a/docs/develop/build_docker_image.mdx+++ b/docs/develop/build_docker_image.mdx@@ -18,12 +18,12 @@ Build the Go backend and web frontend into a local Docker image for development- Docker ≥ 24.0.0 with Docker Compose ≥ v2.26.1 and BuildKit- Access to the `infiniflow/ragflow_deps:latest` and `infiniflow/github_action_runner:latest` images during the build-The documented Go image target is `linux/amd64`. On an Apple Silicon Mac, Docker Desktop builds and runs this image through x86-64 emulation.+The documented Go image target is `linux/amd64`. macOS is temporarily not supported by the Go backend; use a Linux x86_64 host (or a Linux x86_64 virtual machine) to run the Go services.## Platform support-- **Linux x86-64:** This is the supported Docker build target. In the RAGFlow open-source 1.0 release, DeepDoc uses CPU inference for layout analysis, OCR, and table recognition.-- **Apple Silicon macOS:** Build and run the `linux/amd64` image through Docker Desktop x86-64 emulation. Document processing and image builds may be slower than on an x86-64 Linux host.+- **Linux x86-64:** This is the only supported Docker build target. In the RAGFlow open-source 1.0 release, DeepDoc uses CPU inference for layout analysis, OCR, and table recognition.+- **macOS:** Temporarily not supported by the Go backend. The server depends on native libraries published only for Linux x86-64, so the `linux/amd64` image cannot be built or run reliably on macOS (including through Docker Desktop emulation). Use a Linux x86-64 host or a Linux x86-64 virtual machine.- **Linux ARM64:** A native Go Docker build is not currently supported. The Go image depends on native libraries that are published for Linux x86-64. Use a Linux x86-64 host for a supported native build.- **Document engines:** Elasticsearch is the default engine in the Compose example. Infinity and other supported engines may have different CPU, GPU, and architecture requirements; verify the selected engine before deployment.@@ -43,7 +43,7 @@ docker build --platform linux/amd64 -f Dockerfile -t ragflow:go-local .## Start the service-For the default Elasticsearch document engine on Linux, set `vm.max_map_count` to at least 262144 on the Docker host. For macOS, use the Docker Desktop command below instead.+For the default Elasticsearch document engine on Linux, set `vm.max_map_count` to at least 262144 on the Docker host.```bashsudo sysctl -w vm.max_map_count=262144@@ -70,32 +70,3 @@ A healthy API returns HTTP 200. If you changed `SVR_WEB_HTTP_PORT` in `.env`, usFor a development checkout, a database version error may require `RAGFLOW_DEV_MODE=true` in `.env`. Use this only for local development; keep it `false` for production.-## macOS with Docker Desktop--The same Go image and Compose file work on macOS. On Apple Silicon, keep `--platform linux/amd64` in the build command so that the x86-64 Go image and native libraries use the same architecture. Emulation can make the build and document processing slower than on an x86-64 Linux host.--1. Start Docker Desktop and build from the repository root:-- ```bash- git clone https://github.com/infiniflow/ragflow.git- cd ragflow- docker build --platform linux/amd64 -f Dockerfile -t ragflow:go-local .- ```--2. If you use the default Elasticsearch document engine, set `vm.max_map_count` inside Docker Desktop's Linux virtual machine:-- ```bash- docker run --rm --privileged alpine sysctl -w vm.max_map_count=262144- ```-- Repeat this command after restarting Docker Desktop. It is unnecessary when using another document engine such as Infinity.--3. Set `RAGFLOW_IMAGE=ragflow:go-local` in `docker/.env`, then start the Go stack:-- ```bash- cd docker- docker compose -f docker-compose.yml up -d- curl -f http://localhost/api/v1/system/healthz- ```-- Wait for the health check to return HTTP 200, then open `http://localhost` in a browser. Include `SVR_WEB_HTTP_PORT` in both URLs if you changed its default value.diff --git a/docs/develop/launch_ragflow_from_source.md b/docs/develop/launch_ragflow_from_source.mdindex dc1752c09a..e5d8423b00 100644--- a/docs/develop/launch_ragflow_from_source.md+++ b/docs/develop/launch_ragflow_from_source.md@@ -13,7 +13,7 @@ sidebar_custom_props: {Build and run the complete Go API, admin, ingestor, and syncer services on your host, with supporting services in Docker. Run all commands from the repository root unless a step says otherwise. This guide uses the default Elasticsearch and MySQL configuration on Ubuntu 24.04 x86_64; the native ONNX Runtime archive used by this build targets Linux x86_64.:::note macOS-This source-build procedure is for Ubuntu 24.04 x86_64. On macOS, use Docker Desktop and follow [Build RAGFlow Docker Image](./build_docker_image.mdx) to build and run the Go `linux/amd64` image.+This source-build procedure is for Ubuntu 24.04 x86_64. macOS is temporarily not supported by the Go backend, so use a Linux x86_64 host to build and run the Go services.:::The RAGFlow open-source 1.0 DeepDoc backend uses CPU inference for layout analysis, OCR, and table recognition.diff --git a/internal/development.md b/internal/development.mdindex 3bec130058..348c3e3f2d 100644--- a/internal/development.md+++ b/internal/development.md@@ -59,12 +59,13 @@ The image contains Go DeepDoc weights, tokenizer assets, the BPE table, and stag>> ```bash> RAGFLOW_DEPS="${HOME}/ragflow-native-libs" # created by download_deps.py-> PLATFORM="linux_amd64" # or darwin_amd64, linux_arm64, darwin_arm64+> PLATFORM="linux_amd64" # macOS (darwin_*) is temporarily unsupported; linux_arm64 is not a supported native build target> # NOTE: the ONNX Runtime static lib fetched by download_deps.py is> # linux-x64 ONLY (onnxruntime-linux-x64-static_lib-*). On darwin_* / non-amd64> # PLATFORM values the production DeepDoc backend cannot be linked, so those> # PLATFORM examples cover office_oxide/pdfium/pdf_oxide only — ORT is a-> # Linux-amd64 link dependency here.+> # Linux-amd64 link dependency here. macOS is temporarily not supported by the+> # Go backend; use a Linux x86-64 host for a supported native build.>> # Resolve the version-stamped ORT archive path FIRST, in its own unquoted> # assignment: the shell does not expand `*` inside the double-quoted