From 6119c882e9903b30cd42c208f095ff5e1fc132a1 Mon Sep 17 00:00:00 2001 From: April M <36110273+aimurphy@users.noreply.github.com> Date: Wed, 7 Jan 2026 05:47:28 -0800 Subject: [PATCH 01/12] add algolia block --- docs/docusaurus.config.js | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/docs/docusaurus.config.js b/docs/docusaurus.config.js index 839ca12f..ab2920e8 100644 --- a/docs/docusaurus.config.js +++ b/docs/docusaurus.config.js @@ -121,6 +121,15 @@ const config = { }, ], }, + algolia: { + appId: "SMEA51Q5OL", + // public key, safe to commit + apiKey: "b2ec302e9880e8979ad6a68f0c36271e", + indexName: "openrag", + contextualSearch: true, + searchParameters: {}, + searchPagePath: "search", + }, prism: { theme: prismThemes.github, darkTheme: prismThemes.dracula, From cdec80288e624b6800f4acd7dc5cf809636b57a3 Mon Sep 17 00:00:00 2001 From: Steven Harris Date: Sun, 11 Jan 2026 14:06:19 -0800 Subject: [PATCH 02/12] Updated GPU resource reservations to docker-compose Original version was failing on Ubuntu EC2 instance with GPU - error message was: 'validating /home/ubuntu/.openrag/tui/docker-compose.gpu.yml: services.openrag-backend Additional property gpus is not allowed Command exited with status 15 --- docker-compose.gpu.yml | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/docker-compose.gpu.yml b/docker-compose.gpu.yml index 4496c4ac..b849cd3b 100644 --- a/docker-compose.gpu.yml +++ b/docker-compose.gpu.yml @@ -3,5 +3,10 @@ services: environment: - NVIDIA_DRIVER_CAPABILITIES=compute,utility - NVIDIA_VISIBLE_DEVICES=all - gpus: all - + deploy: + resources: + reservations: + devices: + - driver: nvidia + count: all + capabilities: [gpu] From f81d0224b303dc7642c2476463b4daa37aa83d33 Mon Sep 17 00:00:00 2001 From: phact Date: Tue, 13 Jan 2026 09:33:51 -0500 Subject: [PATCH 03/12] use U,z for opensearch data --- docker-compose.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docker-compose.yml b/docker-compose.yml index 79826b3a..c5f809c5 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -29,7 +29,7 @@ services: - "9200:9200" - "9600:9600" volumes: - - ${OPENSEARCH_DATA_PATH:-./opensearch-data}:/usr/share/opensearch/data:Z + - ${OPENSEARCH_DATA_PATH:-./opensearch-data}:/usr/share/opensearch/data:U,z dashboards: image: opensearchproject/opensearch-dashboards:3.0.0 From b9e65ed4b99a819a964129fd615adc271eb8fb52 Mon Sep 17 00:00:00 2001 From: phact Date: Tue, 13 Jan 2026 12:11:10 -0500 Subject: [PATCH 04/12] new env var to override docling serve host --- src/api/docling.py | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-) diff --git a/src/api/docling.py b/src/api/docling.py index 22b709ef..2f9adcbd 100644 --- a/src/api/docling.py +++ b/src/api/docling.py @@ -1,5 +1,6 @@ """Docling service proxy endpoints.""" +import os import socket import struct from pathlib import Path @@ -73,9 +74,15 @@ def determine_docling_host() -> str: return "localhost" -# Detect the host IP once at startup -HOST_IP = determine_docling_host() -DOCLING_SERVICE_URL = f"http://{HOST_IP}:5001" +# Use explicit URL if provided, otherwise auto-detect host +_docling_url_override = os.getenv("DOCLING_SERVE_URL") +if _docling_url_override: + DOCLING_SERVICE_URL = _docling_url_override.rstrip("/") + HOST_IP = _docling_url_override # For display in health responses + logger.info("Using DOCLING_SERVE_URL override: %s", DOCLING_SERVICE_URL) +else: + HOST_IP = determine_docling_host() + DOCLING_SERVICE_URL = f"http://{HOST_IP}:5001" async def health(request: Request) -> JSONResponse: From df3a9f72800e3067eb822c8803d5123890f64240 Mon Sep 17 00:00:00 2001 From: April M <36110273+aimurphy@users.noreply.github.com> Date: Tue, 13 Jan 2026 10:28:20 -0800 Subject: [PATCH 05/12] add small api/sdk page --- docs/docs/reference/api-sdk-overview.mdx | 12 ++++++++++++ docs/sidebars.js | 5 +++++ 2 files changed, 17 insertions(+) create mode 100644 docs/docs/reference/api-sdk-overview.mdx diff --git a/docs/docs/reference/api-sdk-overview.mdx b/docs/docs/reference/api-sdk-overview.mdx new file mode 100644 index 00000000..d3a7418f --- /dev/null +++ b/docs/docs/reference/api-sdk-overview.mdx @@ -0,0 +1,12 @@ +--- +title: OpenRAG APIs and SDKs +slug: /reference/api-sdk-overview +--- + +You can use OpenRAG's APIs and SDKs to integrate and extend OpenRAG's capabilities: + +* [Python SDK](https://github.com/langflow-ai/openrag/tree/main/sdks/python) +* [TypeScript/JavaScript SDK](https://github.com/langflow-ai/openrag/tree/main/sdks/typescript) + + + \ No newline at end of file diff --git a/docs/sidebars.js b/docs/sidebars.js index bc11ffa6..0cc0be91 100644 --- a/docs/sidebars.js +++ b/docs/sidebars.js @@ -75,6 +75,11 @@ const sidebars = { label: "Chat", }, "reference/configuration", + { + type: "doc", + id: "reference/api-sdk-overview", + label: "APIs and SDKs", + }, "support/contribute", "support/troubleshoot", ], From de29a80cbadfcf2a44458414e67087e8e7811c77 Mon Sep 17 00:00:00 2001 From: ming luo Date: Tue, 13 Jan 2026 13:55:12 -0500 Subject: [PATCH 06/12] add docker compose --- .github/workflows/test-integration.yml | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/.github/workflows/test-integration.yml b/.github/workflows/test-integration.yml index ab40f4cd..ed6e325e 100644 --- a/.github/workflows/test-integration.yml +++ b/.github/workflows/test-integration.yml @@ -72,6 +72,12 @@ jobs: - name: Python version run: uv python install 3.13 + - name: Install docker-compose + run: | + sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose + sudo chmod +x /usr/local/bin/docker-compose + docker-compose --version + - name: Install dependencies run: uv sync From 18447c2a4e9819a13ef33c081f02faaa3f7283a7 Mon Sep 17 00:00:00 2001 From: ming luo Date: Tue, 13 Jan 2026 14:01:00 -0500 Subject: [PATCH 07/12] use sudo apt-get --- .github/workflows/test-integration.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/workflows/test-integration.yml b/.github/workflows/test-integration.yml index ed6e325e..c4f9555b 100644 --- a/.github/workflows/test-integration.yml +++ b/.github/workflows/test-integration.yml @@ -74,8 +74,8 @@ jobs: - name: Install docker-compose run: | - sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose - sudo chmod +x /usr/local/bin/docker-compose + sudo apt-get update + sudo apt-get install -y docker-compose docker-compose --version - name: Install dependencies From 7fa693b7b59358191ad3acff2434c0f28c40f1a2 Mon Sep 17 00:00:00 2001 From: phact Date: Tue, 13 Jan 2026 14:15:51 -0500 Subject: [PATCH 08/12] .env.example --- .env.example | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/.env.example b/.env.example index 5a5f6429..849b94ad 100644 --- a/.env.example +++ b/.env.example @@ -66,6 +66,10 @@ EMBEDDING_MODEL= # OPTIONAL url for openrag link to langflow in the UI LANGFLOW_PUBLIC_URL= +# OPTIONAL: Override the full docling-serve URL (e.g., for remote instances) +# If not set, auto-detects host and uses port 5001 +# DOCLING_SERVE_URL=http://my-docling-server:5001 + # OPTIONAL: Override host for docling service (for special networking setups) # HOST_DOCKER_INTERNAL=host.containers.internal From dc5513fe508fc741675c33bf60df780d25240e83 Mon Sep 17 00:00:00 2001 From: ming Date: Tue, 13 Jan 2026 14:23:58 -0500 Subject: [PATCH 09/12] remove docker-compose test-integration.yml --- .github/workflows/test-integration.yml | 6 ------ 1 file changed, 6 deletions(-) diff --git a/.github/workflows/test-integration.yml b/.github/workflows/test-integration.yml index c4f9555b..ab40f4cd 100644 --- a/.github/workflows/test-integration.yml +++ b/.github/workflows/test-integration.yml @@ -72,12 +72,6 @@ jobs: - name: Python version run: uv python install 3.13 - - name: Install docker-compose - run: | - sudo apt-get update - sudo apt-get install -y docker-compose - docker-compose --version - - name: Install dependencies run: uv sync From 10738303a76b729695883be5b1cfc50464c23857 Mon Sep 17 00:00:00 2001 From: "April I. Murphy" <36110273+aimurphy@users.noreply.github.com> Date: Tue, 13 Jan 2026 12:19:27 -0800 Subject: [PATCH 10/12] Update docs/docusaurus.config.js --- docs/docusaurus.config.js | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/docusaurus.config.js b/docs/docusaurus.config.js index d8a9acf1..62345bb8 100644 --- a/docs/docusaurus.config.js +++ b/docs/docusaurus.config.js @@ -248,7 +248,7 @@ const config = { appId: "SMEA51Q5OL", // public key, safe to commit apiKey: "b2ec302e9880e8979ad6a68f0c36271e", - indexName: "openrag", + indexName: "openrag-algolia", contextualSearch: true, searchParameters: {}, searchPagePath: "search", From b4ec305652a82c1534c936cd15b3d40bdbcebd6e Mon Sep 17 00:00:00 2001 From: ming luo Date: Tue, 13 Jan 2026 16:54:24 -0500 Subject: [PATCH 11/12] fix docker build gh runner --- .github/workflows/build-multiarch.yml | 13 ++++--------- 1 file changed, 4 insertions(+), 9 deletions(-) diff --git a/.github/workflows/build-multiarch.yml b/.github/workflows/build-multiarch.yml index 077b66ec..d832bcd1 100644 --- a/.github/workflows/build-multiarch.yml +++ b/.github/workflows/build-multiarch.yml @@ -69,8 +69,7 @@ jobs: tag: langflowai/openrag-backend platform: linux/arm64 arch: arm64 - #runs-on: [self-hosted, linux, ARM64, langflow-ai-arm64-2] - runs-on: RagRunner + runs-on: [self-hosted, Linux, ARM64, langflow-ai-arm64-40gb] # frontend - image: frontend @@ -84,8 +83,7 @@ jobs: tag: langflowai/openrag-frontend platform: linux/arm64 arch: arm64 - #runs-on: [self-hosted, linux, ARM64, langflow-ai-arm64-2] - runs-on: RagRunner + runs-on: [self-hosted, Linux, ARM64, langflow-ai-arm64-40gb] # langflow - image: langflow @@ -99,8 +97,7 @@ jobs: tag: langflowai/openrag-langflow platform: linux/arm64 arch: arm64 - #runs-on: self-hosted - runs-on: RagRunner + runs-on: [self-hosted, Linux, ARM64, langflow-ai-arm64-40gb] # opensearch - image: opensearch @@ -114,9 +111,7 @@ jobs: tag: langflowai/openrag-opensearch platform: linux/arm64 arch: arm64 - #runs-on: [self-hosted, linux, ARM64, langflow-ai-arm64-2] - #runs-on: self-hosted - runs-on: RagRunner + runs-on: [self-hosted, Linux, ARM64, langflow-ai-arm64-40gb] runs-on: ${{ matrix.runs-on }} From 5904475a45eef44c1ffe53ab3158a7673eb2e743 Mon Sep 17 00:00:00 2001 From: ming luo Date: Tue, 13 Jan 2026 17:04:18 -0500 Subject: [PATCH 12/12] try langflow-ai-arm64-40gb-ephemeral --- .github/workflows/build-multiarch.yml | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/.github/workflows/build-multiarch.yml b/.github/workflows/build-multiarch.yml index d832bcd1..1f06553c 100644 --- a/.github/workflows/build-multiarch.yml +++ b/.github/workflows/build-multiarch.yml @@ -69,7 +69,7 @@ jobs: tag: langflowai/openrag-backend platform: linux/arm64 arch: arm64 - runs-on: [self-hosted, Linux, ARM64, langflow-ai-arm64-40gb] + runs-on: [self-hosted, Linux, ARM64, langflow-ai-arm64-40gb-ephemeral] # frontend - image: frontend @@ -83,7 +83,7 @@ jobs: tag: langflowai/openrag-frontend platform: linux/arm64 arch: arm64 - runs-on: [self-hosted, Linux, ARM64, langflow-ai-arm64-40gb] + runs-on: [self-hosted, Linux, ARM64, langflow-ai-arm64-40gb-ephemeral] # langflow - image: langflow @@ -97,7 +97,7 @@ jobs: tag: langflowai/openrag-langflow platform: linux/arm64 arch: arm64 - runs-on: [self-hosted, Linux, ARM64, langflow-ai-arm64-40gb] + runs-on: [self-hosted, Linux, ARM64, langflow-ai-arm64-40gb-ephemeral] # opensearch - image: opensearch @@ -111,7 +111,7 @@ jobs: tag: langflowai/openrag-opensearch platform: linux/arm64 arch: arm64 - runs-on: [self-hosted, Linux, ARM64, langflow-ai-arm64-40gb] + runs-on: [self-hosted, Linux, ARM64, langflow-ai-arm64-40gb-ephemeral] runs-on: ${{ matrix.runs-on }}