Skip to content

Commit 339df13

Browse files
bbertuccclaude
andauthored
docs(config): clarify DOCLING_SERVE_URL default is compose-only (#134)
The default value 'http://docling-serve:5001' only resolves inside the docker-compose dev stack (where 'docling-serve' is the service name). An operator deploying anywhere else — Kubernetes, ECS without the bundled compose file, a single VM, anything — sees the default, nothing complains at startup, and every document submission silently fails when the api can't connect. Expand the Field description to say so plainly: it's required, there is no in-process fallback, and these are the two address shapes operators actually use: http://localhost:5001 — sidecar in the same task / pod http://<dns-or-host>:5001 — separate docling-serve service No behaviour change. Docstring-only. Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent 7409584 commit 339df13

1 file changed

Lines changed: 10 additions & 1 deletion

File tree

src/config.py

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -155,7 +155,16 @@ class Settings(BaseSettings):
155155
# Docling-serve sidecar configuration
156156
docling_serve_url: str = Field(
157157
default="http://docling-serve:5001",
158-
description="Base URL of the docling-serve sidecar",
158+
description=(
159+
"Base URL of the docling-serve service. **Required** — every "
160+
"document submission calls this; there is no in-process docling "
161+
"fallback. The default 'http://docling-serve:5001' resolves only "
162+
"inside the docker-compose dev stack, where 'docling-serve' is "
163+
"the compose service name. For any other deployment set this to "
164+
"the actual address: 'http://localhost:5001' when docling-serve "
165+
"runs as a sidecar in the same task/pod, or the full "
166+
"DNS/hostname of a separate docling-serve service otherwise."
167+
),
159168
)
160169
docling_serve_timeout: float = Field(
161170
ge=10.0,

0 commit comments

Comments
 (0)