From b9e65ed4b99a819a964129fd615adc271eb8fb52 Mon Sep 17 00:00:00 2001
From: phact <estevezsebastian@gmail.com>
Date: Tue, 13 Jan 2026 12:11:10 -0500
Subject: [PATCH 1/5] 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 de29a80cbadfcf2a44458414e67087e8e7811c77 Mon Sep 17 00:00:00 2001
From: ming luo <itestmycode@gmail.com>
Date: Tue, 13 Jan 2026 13:55:12 -0500
Subject: [PATCH 2/5] 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 <itestmycode@gmail.com>
Date: Tue, 13 Jan 2026 14:01:00 -0500
Subject: [PATCH 3/5] 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 <estevezsebastian@gmail.com>
Date: Tue, 13 Jan 2026 14:15:51 -0500
Subject: [PATCH 4/5] .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 <itestmycode@gmail.com>
Date: Tue, 13 Jan 2026 14:23:58 -0500
Subject: [PATCH 5/5] 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