### Quick Start Java Client Example

Source: https://github.com/docling-project/docling-java/blob/main/docs/src/doc/docs/docling-serve/serve-client.md

Demonstrates how to create a Docling Serve API client, build a conversion request for a document from a URL, and process the response. Ensure Jackson is included in your project.

```java
import java.net.URI;
import ai.docling.serve.api.DoclingServeApi;
import ai.docling.serve.api.convert.request.ConvertDocumentRequest;
import ai.docling.serve.api.convert.request.options.ConvertDocumentOptions;
import ai.docling.serve.api.convert.request.options.OutputFormat;
import ai.docling.serve.api.convert.request.source.HttpSource;
import ai.docling.serve.api.convert.request.target.InBodyTarget;
import ai.docling.serve.api.convert.response.InBodyConvertDocumentResponse;

DoclingServeApi api = DoclingServeApi.builder()
    .baseUrl("http://localhost:8000") // your Docling Serve URL
    .logRequests() // log HTTP requests
    .logResponses() // log HTTP responses
    .prettyPrint() // pretty-print JSON requests/responses
    .build();

ConvertDocumentRequest request = ConvertDocumentRequest.builder()
    .source(HttpSource.builder().url(URI.create("https://arxiv.org/pdf/2408.09869")).build())
    .options(ConvertDocumentOptions.builder()
        .toFormat(OutputFormat.MARKDOWN)
        .includeImages(true)
        .build())
    .target(InBodyTarget.builder().build())
    .build();

InBodyConvertDocumentResponse response = (InBodyConvertDocumentResponse) api.convertSource(request);
System.out.println(response.getDocument().getMarkdownContent());
```

--------------------------------

### HTTP Source Configuration

Source: https://github.com/docling-project/docling-java/blob/main/docs/src/doc/docs/docling-serve/serve-client.md

Example of configuring an HTTP source for the Docling Serve API.

```APIDOC
## HTTP Source Configuration

### Description
Configure an HTTP source by providing a URL. Optional headers can also be set.

### Method
N/A (Client-side configuration)

### Endpoint
N/A (Client-side configuration)

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
N/A

### Request Example
```java
import ai.docling.serve.api.convert.request.source.HttpSource;
import java.net.URI;

var httpSource = HttpSource.builder()
    .url(URI.create("https://example.com/file.pdf"))
    // .header("Authorization", "Bearer ...")
    .build();
```

### Response
N/A (Client-side configuration)
```

--------------------------------

### Docling Server Logs Example

Source: https://github.com/docling-project/docling-java/blob/main/docs/src/doc/docs/includes/docling-serve/serve-compatibility.md

This log output indicates the successful startup of the Docling production server and provides the URLs for accessing the documentation and scalar documentation.

```text
Starting production server 🚀

Server started at http://0.0.0.0:5001
Documentation at http://0.0.0.0:5001/docs
Scalar docs at http://0.0.0.0:5001/scalar

```

--------------------------------

### Initialize DoclingServeContainer

Source: https://github.com/docling-project/docling-java/blob/main/docling-testing/docling-version-tests/README.md

Configures and starts a DoclingServeContainer for testing. Specify the Docker image, registry, and startup timeout. Ensure Testcontainers and Docker are set up correctly.

```java
var containerConfig = DoclingServeContainerConfig.builder()
        .image("{registry}/{image}:{tag}")
        .startupTimeout(Duration.ofMinutes(5))
        .build();
    var doclingContainer = new DoclingServeContainer(containerConfig);
    doclingContainer.start();
```

--------------------------------

### Docling Server Startup Logs

Source: https://github.com/docling-project/docling-java/blob/main/docs/src/doc/docs/includes/docling-serve/serve-compatibility.md

Shows the typical log output when the Docling production server starts, including the server address and documentation endpoints.

```text
Starting production server 🚀

Server started at http://0.0.0.0:5001
Documentation at http://0.0.0.0:5001/docs
Scalar docs at http://0.0.0.0:5001/scalar


```

--------------------------------

### Docling Serve v1.15.0 Logs

Source: https://github.com/docling-project/docling-java/blob/main/docs/src/doc/docs/includes/docling-serve/serve-compatibility.md

These logs show the startup sequence and operational messages for Docling serve version 1.15.0. They include server start confirmation, documentation paths, and details about the OCR engine initialization. A deprecation warning for `strict_text` is also noted.

```log
Starting production server 🚀\n\nServer started at http://0.0.0.0:5001\nDocumentation at http://0.0.0.0:5001/docs\nScalar docs at http://0.0.0.0:5001/scalar\n\nLogs:\nINFO:     Started server process [1]\nINFO:     Waiting for application startup.\n2026-06-15 11:58:55.323809457 [W:onnxruntime:Default, device_discovery.cc:132 GetPciBusId] Skipping pci_bus_id for PCI path at "/sys/devices/LNXSYSTM:00/LNXSYBUS:00/ACPI0004:00/MSFT1000:00/5620e0c7-8062-4dce-aeb7-520c7ef76171" because filename ""5620e0c7-8062-4dce-aeb7-520c7ef76171"" dit not match expected pattern of [0-9a-f]+:[0-9a-f]+:[0-9a-f]+[.][0-9a-f]+\n[INFO] 2026-06-15 11:58:56,235 [RapidOCR] base.py:22: Using engine_name: onnxruntime\n[INFO] 2026-06-15 11:58:56,237 [RapidOCR] main.py:53: Using /opt/app-root/src/.cache/docling/models/RapidOcr/onnx/PP-OCRv4/det/ch_PP-OCRv4_det_infer.onnx\n[INFO] 2026-06-15 11:58:56,412 [RapidOCR] base.py:22: Using engine_name: onnxruntime\n[INFO] 2026-06-15 11:58:56,412 [RapidOCR] main.py:53: Using /opt/app-root/src/.cache/docling/models/RapidOcr/onnx/PP-OCRv4/cls/ch_ppocr_mobile_v2.0_cls_infer.onnx\n[INFO] 2026-06-15 11:58:56,459 [RapidOCR] base.py:22: Using engine_name: onnxruntime\n[INFO] 2026-06-15 11:58:56,459 [RapidOCR] main.py:53: Using /opt/app-root/src/.cache/docling/models/RapidOcr/onnx/PP-OCRv4/rec/ch_PP-OCRv4_rec_infer.onnx\nINFO:     Application startup complete.\nINFO:     Uvicorn running on http://0.0.0.0:5001 (Press CTRL+C to quit)\nINFO:     172.17.0.1:56546 - "GET /health HTTP/1.1" 200 OK\nINFO:     172.17.0.1:56550 - "GET /health HTTP/1.1" 200 OK\nWARNING:docling_core.types.doc.document:Parameter `strict_text` has been deprecated and will be ignored.\nINFO:     172.17.0.1:56550 - "POST /v1/convert/source HTTP/1.1" 200 OK\nINFO:     172.17.0.1:56550 - "POST /v1/convert/source HTTP/1.1" 200 OK\nINFO:     172.17.0.1:56550 - "POST /v1/convert/source HTTP/1.1" 200 OK\nINFO:     172.17.0.1:56550 - "GET /v1/clear/converters HTTP/1.1" 200 OK\nINFO:     172.17.0.1:56550 - "GET /v1/clear/results?older_then=3600 HTTP/1.1" 200 OK\n
```

--------------------------------

### Presigned URL Target Configuration

Source: https://github.com/docling-project/docling-java/blob/main/docs/src/doc/docs/docling-serve/serve-client.md

Example of configuring the target to receive results as presigned download URLs.

```APIDOC
## Presigned URL Target Configuration

### Description
Configure the target to receive results as presigned download URLs. Requires docling-serve v1.22.0+.

### Method
N/A (Client-side configuration)

### Endpoint
N/A (Client-side configuration)

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
N/A

### Request Example
```java
import ai.docling.serve.api.convert.request.target.PresignedUrlTarget;

var presigned = PresignedUrlTarget.builder().build();
```

### Response
N/A (Client-side configuration)
```

--------------------------------

### Convert Document Request

Source: https://github.com/docling-project/docling-java/blob/main/docs/src/doc/docs/testcontainers.md

Example of using the reference client to call the Convert endpoint for document conversion. This snippet demonstrates setting up the request with a source URL and desired output format.

```java
import java.net.URI;
import ai.docling.serve.api.convert.request.ConvertDocumentRequest;
import ai.docling.serve.api.convert.request.options.ConvertDocumentOptions;
import ai.docling.serve.api.convert.request.options.OutputFormat;
import ai.docling.serve.api.convert.request.source.HttpSource;
import ai.docling.serve.api.convert.request.target.InBodyTarget;
import ai.docling.serve.api.convert.response.InBodyConvertDocumentResponse;

String baseUrl = docling.getApiUrl();
DoclingServeApi api = DoclingServeApi.builder()
    .baseUrl(baseUrl)
    .build();

ConvertDocumentRequest request = ConvertDocumentRequest.builder()
    .source(HttpSource.builder().url(URI.create("https://arxiv.org/pdf/2408.09869")).build())
    .options(ConvertDocumentOptions.builder()
        .toFormat(OutputFormat.MARKDOWN)
        .includeImages(true)
        .build())
    .target(InBodyTarget.builder().build())
    .build();

InBodyConvertDocumentResponse response = (InBodyConvertDocumentResponse) api.convertSource(request);
// Assert on response.getDocument().getMarkdownContent(), errors, timings, etc.
```

--------------------------------

### Docling Server Startup and Log Output

Source: https://github.com/docling-project/docling-java/blob/main/docs/src/doc/docs/includes/docling-serve/serve-compatibility.md

This snippet displays the typical log output when the Docling production server starts. It includes server addresses, documentation URLs, and initial processing messages from OCR engines.

```log
Starting production server 🚀

Server started at http://0.0.0.0:5001
Documentation at http://0.0.0.0:5001/docs
Scalar docs at http://0.0.0.0:5001/scalar

Logs:
INFO:     Started server process [1]
INFO:     Waiting for application startup.
2026-06-15 12:01:06.645567614 [W:onnxruntime:Default, device_discovery.cc:132 GetPciBusId] Skipping pci_bus_id for PCI path at "/sys/devices/LNXSYSTM:00/LNXSYBUS:00/ACPI0004:00/MSFT1000:00/5620e0c7-8062-4dce-aeb7-520c7ef76171" because filename ""5620e0c7-8062-4dce-aeb7-520c7ef76171"" dit not match expected pattern of [0-9a-f]+:[0-9a-f]+:[0-9a-f]+[.][0-9a-f]+ [m
[INFO] 2026-06-15 12:01:07,148 [RapidOCR] base.py:22: Using engine_name: onnxruntime
[INFO] 2026-06-15 12:01:07,150 [RapidOCR] main.py:57: Using /opt/app-root/src/.cache/docling/models/RapidOcr/onnx/PP-OCRv4/det/ch_PP-OCRv4_det_mobile.onnx
[INFO] 2026-06-15 12:01:07,273 [RapidOCR] base.py:22: Using engine_name: onnxruntime
[INFO] 2026-06-15 12:01:07,274 [RapidOCR] main.py:57: Using /opt/app-root/src/.cache/docling/models/RapidOcr/onnx/PP-OCRv4/cls/ch_ppocr_mobile_v2.0_cls_mobile.onnx
[INFO] 2026-06-15 12:01:07,323 [RapidOCR] base.py:22: Using engine_name: onnxruntime
[INFO] 2026-06-15 12:01:07,323 [RapidOCR] main.py:57: Using /opt/app-root/src/.cache/docling/models/RapidOcr/onnx/PP-OCRv4/rec/ch_PP-OCRv4_rec_mobile.onnx
Loading weights:   0%|          | 0/770 [00:00<?, ?it/s]Loading weights: 100%|██████████| 770/770 [00:00<00:00, 8716.22it/s]
INFO:     Application startup complete.
INFO:     Uvicorn running on http://0.0.0.0:5001 (Press CTRL+C to quit)
INFO:     172.17.0.1:56630 - "GET /health HTTP/1.1" 200 OK
INFO:     172.17.0.1:56640 - "GET /health HTTP/1.1" 200 OK
[INFO] 2026-06-15 12:01:08,974 [RapidOCR] base.py:22: Using engine_name: onnxruntime
[INFO] 2026-06-15 12:01:08,974 [RapidOCR] main.py:57: Using /opt/app-root/src/.cache/docling/models/RapidOcr/onnx/PP-OCRv4/det/ch_PP-OCRv4_det_mobile.onnx
[INFO] 2026-06-15 12:01:09,071 [RapidOCR] base.py:22: Using engine_name: onnxruntime
[INFO] 2026-06-15 12:01:09,072 [RapidOCR] main.py:57: Using /opt/app-root/src/.cache/docling/models/RapidOcr/onnx/PP-OCRv4/cls/ch_ppocr_mobile_v2.0_cls_mobile.onnx
[INFO] 2026-06-15 12:01:09,141 [RapidOCR] base.py:22: Using engine_name: onnxruntime
[INFO] 2026-06-15 12:01:09,142 [RapidOCR] main.py:57: Using /opt/app-root/src/.cache/docling/models/RapidOcr/onnx/PP-OCRv4/rec/ch_PP-OCRv4_rec_mobile.onnx
Loading weights:   0%|          | 0/770 [00:00<?, ?it/s]Loading weights: 100%|██████████| 770/770 [00:00<00:00, 8318.09it/s]
WARNING:docling_core.types.doc.document:Parameter `strict_text` has been deprecated and will be ignored.
INFO:     172.17.0.1:56640 - "POST /v1/convert/source HTTP/1.1" 200 OK
[INFO] 2026-06-15 12:01:10,983 [RapidOCR] base.py:22: Using engine_name: onnxruntime
[INFO] 2026-06-15 12:01:10,983 [RapidOCR] main.py:57: Using /opt/app-root/src/.cache/docling/models/RapidOcr/onnx/PP-OCRv4/det/ch_PP-OCRv4_det_mobile.onnx
[INFO] 2026-06-15 12:01:11,072 [RapidOCR] base.py:22: Using engine_name: onnxruntime
[INFO] 2026-06-15 12:01:11,072 [RapidOCR] main.py:57: Using /opt/app-root/src/.cache/docling/models/RapidOcr/onnx/PP-OCRv4/cls/ch_ppocr_mobile_v2.0_cls_mobile.onnx
[INFO] 2026-06-15 12:01:11,113 [RapidOCR] base.py:22: Using engine_name: onnxruntime
[INFO] 2026-06-15 12:01:11,113 [RapidOCR] main.py:57: Using /opt/app-root/src/.cache/docling/models/RapidOcr/onnx/PP-OCRv4/rec/ch_PP-OCRv4_rec_mobile.onnx
Loading weights:   0%|          | 0/770 [00:00<?, ?it/s]Loading weights: 100%|██████████| 770/770 [00:00<00:00, 6427.23it/s]
INFO:     172.17.0.1:56640 - "POST /v1/convert/source HTTP/1.1" 200 OK
[INFO] 2026-06-15 12:01:12,998 [RapidOCR] base.py:22: Using engine_name: onnxruntime
[INFO] 2026-06-15 12:01:12,998 [RapidOCR] main.py:57: Using /opt/app-root/src/.cache/docling/models/RapidOcr/onnx/PP-OCRv4/det/ch_PP-OCRv4_det_mobile.onnx
[INFO] 2026-06-15 12:01:13,083 [RapidOCR] base.py:22: Using engine_name: onnxruntime
[INFO] 2026-06-15 12:01:13,084 [RapidOCR] main.py:57: Using /opt/app-root/src/.cache/docling/models/RapidOcr/onnx/PP-OCRv4/cls/ch_ppocr_mobile_v2.0_cls_mobile.onnx
[INFO] 2026-06-15 12:01:13,134 [RapidOCR] base.py:22: Using engine_name: onnxruntime
[INFO] 2026-06-15 12:01:13,134 [RapidOCR] main.py:57: Using /opt/app-root/src/.cache/docling/models/RapidOcr/onnx/PP-OCRv4/rec/ch_PP-OCRv4_rec_mobile.onnx
Loading weights:   0%|          | 0/770 [00:00<?, ?it/s]Loading weights:  86%|████████▌ | 660/770 [00:00<00:00, 6581.18it/s]Loading weights: 100%|██████████| 770/770 [00:00<00:00, 6614.27it/s]
INFO:     172.17.0.1:56640 - "POST /v1/convert/source HTTP/1.1" 200 OK
[INFO] 2026-06-15 12:01:12,998 [RapidOCR] base.py:22: Using engine_name: onnxruntime
[INFO] 2026-06-15 12:01:12,998 [RapidOCR] main.py:57: Using /opt/app-root/src/.cache/docling/models/RapidOcr/onnx/PP-OCRv4/det/ch_PP-OCRv4_det_mobile.onnx
[INFO] 2026-06-15 12:01:13,083 [RapidOCR] base.py:22: Using engine_name: onnxruntime
[INFO] 2026-06-15 12:01:13,084 [RapidOCR] main.py:57: Using /opt/app-root/src/.cache/docling/models/RapidOcr/onnx/PP-OCRv4/cls/ch_ppocr_mobile_v2.0_cls_mobile.onnx
[INFO] 2026-06-15 12:01:13,134 [RapidOCR] base.py:22: Using engine_name: onnxruntime
[INFO] 2026-06-15 12:01:13,134 [RapidOCR] main.py:57: Using /opt/app-root/src/.cache/docling/models/RapidOcr/onnx/PP-OCRv4/rec/ch_PP-OCRv4_rec_mobile.onnx
Loading weights:   0%|          | 0/770 [00:00<?, ?it/s]Loading weights:  81%|████████  | 622/770 [00:00<00:00, 6216.14it/s]Loading weights: 100%|██████████| 770/770 [00:00<00:00, 6427.23it/s]
INFO:     172.17.0.1:56640 - "POST /v1/convert/source HTTP/1.1" 200 OK
INFO:     172.17.0.1:56640 - "GET /v1/clear/converters HTTP/1.1" 200 OK
INFO:     172.17.0.1:56640 - "GET /v1/clear/results?older_then=3600 HTTP/1.1" 200 OK

```

--------------------------------

### File Upload (Base64) Source Configuration

Source: https://github.com/docling-project/docling-java/blob/main/docs/src/doc/docs/docling-serve/serve-client.md

Example of configuring a file upload source using Base64 encoding.

```APIDOC
## File Upload (Base64) Source Configuration

### Description
Configure a file source by uploading file content as a Base64 encoded string, along with the filename.

### Method
N/A (Client-side configuration)

### Endpoint
N/A (Client-side configuration)

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
N/A

### Request Example
```java
import ai.docling.serve.api.convert.request.source.FileSource;
import java.util.Base64;

byte[] bytes = /* read file */
var fileSource = FileSource.builder()
    .filename("report.pdf")
    .base64String(Base64.getEncoder().encodeToString(bytes))
    .build();
```

### Response
N/A (Client-side configuration)
```

--------------------------------

### In-Body Target Configuration

Source: https://github.com/docling-project/docling-java/blob/main/docs/src/doc/docs/docling-serve/serve-client.md

Example of configuring the target to deliver results directly in the response body.

```APIDOC
## In-Body Target Configuration

### Description
Configure the target to receive results directly within the response body. This is the default behavior.

### Method
N/A (Client-side configuration)

### Endpoint
N/A (Client-side configuration)

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
N/A

### Request Example
```java
import ai.docling.serve.api.convert.request.target.InBodyTarget;

var target = InBodyTarget.builder().build();
```

### Response
N/A (Client-side configuration)
```

--------------------------------

### Full Project Build

Source: https://github.com/docling-project/docling-java/blob/main/CLAUDE.md

Execute a full build of the project using Gradle. This command ensures all modules are compiled and tested.

```bash
./gradlew --no-daemon build
```

--------------------------------

### HTTP PUT Target Configuration

Source: https://github.com/docling-project/docling-java/blob/main/docs/src/doc/docs/docling-serve/serve-client.md

Example of configuring the target to upload results to a specified URI via HTTP PUT.

```APIDOC
## HTTP PUT Target Configuration

### Description
Configure the target to upload results to a specified URI using an HTTP PUT request. Optional headers can be included.

### Method
N/A (Client-side configuration)

### Endpoint
N/A (Client-side configuration)

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
N/A

### Request Example
```java
import ai.docling.serve.api.convert.request.target.PutTarget;
import java.net.URI;

var put = PutTarget.builder()
    .uri(URI.create("https://storage.example.com/out/report.md"))
    // .header("Authorization", "Bearer ...")
    .build();
```

### Response
N/A (Client-side configuration)
```

--------------------------------

### Docling Serve v1.14.3 Logs

Source: https://github.com/docling-project/docling-java/blob/main/docs/src/doc/docs/includes/docling-serve/serve-compatibility.md

These logs detail the startup process and operational output for Docling serve version 1.14.3. They include server initialization, API endpoint information, and OCR model loading details. A warning regarding the deprecated `strict_text` parameter is also present.

```log
Starting production server 🚀\n\nServer started at http://0.0.0.0:5001\nDocumentation at http://0.0.0.0:5001/docs\nScalar docs at http://0.0.0.0:5001/scalar\n\nLogs:\nINFO:     Started server process [1]\nINFO:     Waiting for application startup.\n2026-06-15 11:57:09.207551530 [W:onnxruntime:Default, device_discovery.cc:131 GetPciBusId] Skipping pci_bus_id for PCI path at "/sys/devices/LNXSYSTM:00/LNXSYBUS:00/ACPI0004:00/MSFT1000:00/5620e0c7-8062-4dce-aeb7-520c7ef76171" because filename ""5620e0c7-8062-4dce-aeb7-520c7ef76171"" dit not match expected pattern of [0-9a-f]+:[0-9a-f]+:[0-9a-f]+[.][0-9a-f]+\n[INFO] 2026-06-15 11:57:09,693 [RapidOCR] base.py:22: Using engine_name: onnxruntime\n[INFO] 2026-06-15 11:57:09,695 [RapidOCR] main.py:53: Using /opt/app-root/src/.cache/docling/models/RapidOcr/onnx/PP-OCRv4/det/ch_PP-OCRv4_det_infer.onnx\n[INFO] 2026-06-15 11:57:09,774 [RapidOCR] base.py:22: Using engine_name: onnxruntime\n[INFO] 2026-06-15 11:57:09,775 [RapidOCR] main.py:53: Using /opt/app-root/src/.cache/docling/models/RapidOcr/onnx/PP-OCRv4/cls/ch_ppocr_mobile_v2.0_cls_infer.onnx\n[INFO] 2026-06-15 11:57:09,817 [RapidOCR] base.py:22: Using engine_name: onnxruntime\n[INFO] 2026-06-15 11:57:09,817 [RapidOCR] main.py:53: Using /opt/app-root/src/.cache/docling/models/RapidOcr/onnx/PP-OCRv4/rec/ch_PP-OCRv4_rec_infer.onnx\nINFO:     Application startup complete.\nINFO:     Uvicorn running on http://0.0.0.0:5001 (Press CTRL+C to quit)\nINFO:     172.17.0.1:51270 - "GET /health HTTP/1.1" 200 OK\nINFO:     172.17.0.1:51282 - "GET /health HTTP/1.1" 200 OK\nWARNING:docling_core.types.doc.document:Parameter `strict_text` has been deprecated and will be ignored.\nINFO:     172.17.0.1:51282 - "POST /v1/convert/source HTTP/1.1" 200 OK\nINFO:     172.17.0.1:51282 - "POST /v1/convert/source HTTP/1.1" 200 OK\nINFO:     172.17.0.1:51282 - "POST /v1/convert/source HTTP/1.1" 200 OK\nINFO:     172.17.0.1:51282 - "GET /v1/clear/converters HTTP/1.1" 200 OK\nINFO:     172.17.0.1:51282 - "GET /v1/clear/results?older_then=3600 HTTP/1.1" 200 OK\n
```

--------------------------------

### Example Results Markdown Output

Source: https://github.com/docling-project/docling-java/blob/main/docling-testing/docling-version-tests/README.md

Excerpt from the generated `results.md` file, showing a table with tag, result status (success/failure), and links to details.

```markdown
# Results for ghcr.io/docling-project/docling-serve as of 2026-03-02T14:30:00.123456Z

| Tag | Result | Details |
| --- | ------ | ------- |
| v1.13.0 | ✅ SUCCESS | [Click for run details](#v1.13.0-details) |
| v1.12.0 | ❌ FAILURE | [Click for run details](#v1.12.0-details) |
```

--------------------------------

### Docling Serve v1.14.1 Logs

Source: https://github.com/docling-project/docling-java/blob/main/docs/src/doc/docs/includes/docling-serve/serve-compatibility.md

This snippet displays the log output for the Docling serve container version v1.14.1. It details the server startup process, including network addresses, documentation endpoints, and API activity. A deprecation warning for 'strict_text' is also present.

```log
Starting production server 🚀\n\nServer started at http://0.0.0.0:5001\nDocumentation at http://0.0.0.0:5001/docs\nScalar docs at http://0.0.0.0:5001/scalar\n\nLogs:\nINFO:     Started server process [1]\nINFO:     Waiting for application startup.\n2026-06-15 11:54:11.336740475 [W:onnxruntime:Default, device_discovery.cc:131 GetPciBusId] Skipping pci_bus_id for PCI path at "/sys/devices/LNXSYSTM:00/LNXSYBUS:00/ACPI0004:00/MSFT1000:00/5620e0c7-8062-4dce-aeb7-520c7ef76171" because filename ""5620e0c7-8062-4dce-aeb7-520c7ef76171"" dit not match expected pattern of [0-9a-f]+:[0-9a-f]+:[0-9a-f]+[.][0-9a-f]+\n[INFO] 2026-06-15 11:54:11,786 [RapidOCR] base.py:22: Using engine_name: onnxruntime\n[INFO] 2026-06-15 11:54:11,787 [RapidOCR] main.py:53: Using /opt/app-root/src/.cache/docling/models/RapidOcr/onnx/PP-OCRv4/det/ch_PP-OCRv4_det_infer.onnx\n[INFO] 2026-06-15 11:54:11,867 [RapidOCR] base.py:22: Using engine_name: onnxruntime\n[INFO] 2026-06-15 11:54:11,867 [RapidOCR] main.py:53: Using /opt/app-root/src/.cache/docling/models/RapidOcr/onnx/PP-OCRv4/cls/ch_ppocr_mobile_v2.0_cls_infer.onnx\n[INFO] 2026-06-15 11:54:11,910 [RapidOCR] base.py:22: Using engine_name: onnxruntime\n[INFO] 2026-06-15 11:54:11,910 [RapidOCR] main.py:53: Using /opt/app-root/src/.cache/docling/models/RapidOcr/onnx/PP-OCRv4/rec/ch_PP-OCRv4_rec_infer.onnx\nINFO:     Application startup complete.\nINFO:     Uvicorn running on http://0.0.0.0:5001 (Press CTRL+C to quit)\nINFO:     172.17.0.1:50668 - "GET /health HTTP/1.1" 200 OK\nINFO:     172.17.0.1:50684 - "GET /health HTTP/1.1" 200 OK\nWARNING:docling_core.types.doc.document:Parameter `strict_text` has been deprecated and will be ignored.\nINFO:     172.17.0.1:50684 - "POST /v1/convert/source HTTP/1.1" 200 OK\nINFO:     172.17.0.1:50684 - "POST /v1/convert/source HTTP/1.1" 200 OK\nINFO:     172.17.0.1:50684 - "POST /v1/convert/source HTTP/1.1" 200 OK\nINFO:     172.17.0.1:50684 - "GET /v1/clear/converters HTTP/1.1" 200 OK\nINFO:     172.17.0.1:50684 - "GET /v1/clear/results?older_then=3600 HTTP/1.1" 200 OK\n
```

--------------------------------

### Customizing the Report Template

Source: https://github.com/docling-project/docling-java/blob/main/docling-testing/docling-version-tests/README.md

Example of using Qute syntax to iterate over test results and display tag information and status within the `results.md` template.

```markdown
{#each results.results}
  Tag: {it.tag}, Status: {it.result.status.name()}
{/each}
```

--------------------------------

### Docling Server Logs v1.23.0

Source: https://github.com/docling-project/docling-java/blob/main/docs/src/doc/docs/includes/docling-serve/serve-compatibility.md

These logs show the startup process of the Docling production server, including initialization of OCR engines, layout engines, and the FastAPI application. They also indicate the successful loading of models and the server's readiness.

```log
Starting production server 🚀\n\nServer started at http://0.0.0.0:5001\nDocumentation at http://0.0.0.0:5001/docs\nScalar docs at http://0.0.0.0:5001/scalar\n\nLogs:\nINFO:\t12:09:03 - docling.models.factories.base_factory - Loading plugin 'docling_defaults'\nINFO:\t12:09:03 - docling.models.factories - Registered ocr engines: ['auto', 'easyocr', 'kserve_v2_ocr', 'ocrmac', 'rapidocr', 'tesserocr', 'tesseract']\nINFO:\t12:09:03 - docling_serve.otel_instrumentation - Setting up OpenTelemetry metrics\nINFO:\t12:09:03 - docling_serve.otel_instrumentation - Enabling Prometheus metrics export\nINFO:\t12:09:03 - docling_serve.otel_instrumentation - Instrumenting FastAPI with OpenTelemetry (excluded_urls=/health$,/readyz$,/ready$,/livez$,/healthz$,/metrics$)\nINFO:\t12:09:03 - uvicorn.error - Started server process [1]\nINFO:\t12:09:03 - uvicorn.error - Waiting for application startup.\nINFO:\t12:09:06 - docling.models.factories.base_factory - Loading plugin 'docling_defaults'\nINFO:\t12:09:06 - docling.models.factories - Registered table structure engines: ['docling_tableformer', 'docling_tableformer_v2', 'granite_vision_table']\nINFO:\t12:09:06 - docling.models.factories.base_factory - Loading plugin 'docling_defaults'\nINFO:\t12:09:06 - docling.models.factories - Registered layout engines: ['layout_object_detection', 'docling_layout_default', 'docling_experimental_table_crops_layout']\nINFO:\t12:09:06 - docling_jobkit.convert.manager - artifacts_path is set to a valid directory. No model weights will be downloaded at runtime.\nINFO:\t12:09:06 - docling.document_converter - Initializing pipeline for StandardPdfPipeline with options hash 1743cd6dac10356c82ba7dfffff4ed02\nINFO:\t12:09:06 - docling.models.factories.base_factory - Loading plugin 'docling_defaults'\nINFO:\t12:09:06 - docling.models.factories - Registered picture descriptions: ['picture_description_vlm_engine', 'vlm', 'api']\n2026-06-15 12:09:06.270603246 [W:onnxruntime:Default, device_discovery.cc:133 GetPciBusId] Skipping pci_bus_id for PCI path at "/sys/devices/LNXSYSTM:00/LNXSYBUS:00/ACPI0004:00/MSFT1000:00/5620e0c7-8062-4dce-aeb7-520c7ef76171" because filename "5620e0c7-8062-4dce-aeb7-520c7ef76171" did not match expected pattern of [0-9a-f]+:[0-9a-f]+:[0-9a-f]+[.][0-9a-f]+\nINFO:\t12:09:06 - docling.utils.accelerator_utils - Accelerator device: 'cpu'\n[INFO] 2026-06-15 12:09:06,492 [RapidOCR] base.py:22: Using engine_name: onnxruntime\n[INFO] 2026-06-15 12:09:06,493 [RapidOCR] main.py:65: Using /opt/app-root/src/.cache/docling/models/RapidOcr/onnx/PP-OCRv4/det/ch_PP-OCRv4_det_mobile.onnx\n[INFO] 2026-06-15 12:09:06,581 [RapidOCR] base.py:22: Using engine_name: onnxruntime\n[INFO] 2026-06-15 12:09:06,581 [RapidOCR] main.py:65: Using /opt/app-root/src/.cache/docling/models/RapidOcr/onnx/PP-OCRv4/cls/ch_ppocr_mobile_v2.0_cls_mobile.onnx\n[INFO] 2026-06-15 12:09:06,626 [RapidOCR] base.py:22: Using engine_name: onnxruntime\n[INFO] 2026-06-15 12:09:06,627 [RapidOCR] main.py:65: Using /opt/app-root/src/.cache/docling/models/RapidOcr/onnx/PP-OCRv4/rec/ch_PP-OCRv4_rec_mobile.onnx\nINFO:\t12:09:06 - docling.models.stages.ocr.auto_ocr_model - Auto OCR model selected rapidocr with onnxruntime.\nINFO:\t12:09:06 - docling.utils.accelerator_utils - Accelerator device: 'cpu'\nLoading weights:   0%|          | 0/770 [00:00<?, ?it/s]Loading weights:  89%|████████▉ | 689/770 [00:00<00:00, 6880.25it/s]Loading weights: 100%|██████████| 770/770 [00:00<00:00, 6889.71it/s]\nINFO:\t12:09:07 - docling.utils.accelerator_utils - Accelerator device: 'cpu'\nINFO:\t12:09:07 - uvicorn.error - Application startup complete.\nINFO:\t12:09:07 - uvicorn.error - Uvicorn running on http://0.0.0.0:5001 (Press CTRL+C to quit)\nINFO:\t12:09:07 - docling_serve.app - Health check requested\nINFO:\t12:09:07 - uvicorn.access - 172.17.0.1:49064 - "GET /health HTTP/1.1" 200\nINFO:\t12:09:07 - docling_serve.app - Health check requested\nINFO:\t12:09:07 - uvicorn.access - 172.17.0.1:49070 - "GET /health HTTP/1.1" 200\nINFO:\t12:09:07 - docling_serve.app - [TENANT_ID] Extracted tenant_id from header: 'default' (header_value: 'None')\nINFO:\t12:09:07 - docling_serve.app - [TENANT_ID] process_url endpoint received tenant_id='default'\nINFO:\t12:09:07 - docling_serve.app - [TENANT_ID] Preparing to enqueue with tenant_id='default' in metadata\nINFO:\t12:09:07 - docling_serve.app - [TENANT_ID] Task 0c384e6c-2230-4705-80a8-8c8764f8997c created with tenant_id='default'\nINFO:\t12:09:07 - docling_jobkit.orchestrators.local.worker - Worker 0 processing task 0c384e6c-2230-4705-80a8-8c8764f8997c\nINFO:\t12:09:07 - docling_jobkit.convert.manager - artifacts_path is set to a valid directory. No model weights will be downloaded at runtime.\n
```

--------------------------------

### Docling Server Production Logs

Source: https://github.com/docling-project/docling-java/blob/main/docling-testing/docling-version-tests/src/test/resources/markdownFileResults/expected-results.md

These logs show the server starting up, its network addresses, and incoming requests. They are useful for monitoring server activity and debugging.

```log
Starting production server 🚀

Server started at http://0.0.0.0:5001
Documentation at http://0.0.0.0:5001/docs
Scalar docs at http://0.0.0.0:5001/scalar

Logs:
INFO:     Started server process [1]
INFO:     Waiting for application startup.
INFO:     Application startup complete.
INFO:     Uvicorn running on http://0.0.0.0:5001 (Press CTRL+C to quit)
INFO:     192.168.127.1:31567 - "GET /health HTTP/1.1" 200 OK
INFO:     192.168.127.1:62557 - "GET /health HTTP/1.1" 200 OK
INFO:     192.168.127.1:62557 - "POST /v1/convert/source HTTP/1.1" 200 OK
```

--------------------------------

### Adding a New Registry Client Configuration

Source: https://github.com/docling-project/docling-java/blob/main/docling-testing/docling-version-tests/README.md

Steps to integrate a new registry client by implementing an interface, annotating it, and configuring its URL in `application.yml`.

```yaml
quarkus:
  rest-client:
    my-registry:
      url: https://my-registry.io
```

--------------------------------

### Docling Serve v1.9.0 Logs

Source: https://github.com/docling-project/docling-java/blob/main/docs/src/doc/docs/includes/docling-serve/serve-compatibility.md

Displays the server startup logs for Docling serve version v1.9.0, including application startup, OCR model loading, and API request handling. Note the deprecation warning for 'strict_text'.

```log
Starting production server 🚀

Server started at http://0.0.0.0:5001
Documentation at http://0.0.0.0:5001/docs
Scalar docs at http://0.0.0.0:5001/scalar

Logs:
INFO:     Started server process [1]
INFO:     Waiting for application startup.
[INFO] 2026-06-15 11:43:46,682 [RapidOCR] base.py:22: Using engine_name: onnxruntime
[INFO] 2026-06-15 11:43:46,684 [RapidOCR] main.py:53: Using /opt/app-root/src/.cache/docling/models/RapidOcr/onnx/PP-OCRv4/det/ch_PP-OCRv4_det_infer.onnx
[INFO] 2026-06-15 11:43:46,773 [RapidOCR] base.py:22: Using engine_name: onnxruntime
[INFO] 2026-06-15 11:43:46,773 [RapidOCR] main.py:53: Using /opt/app-root/src/.cache/docling/models/RapidOcr/onnx/PP-OCRv4/cls/ch_ppocr_mobile_v2.0_cls_infer.onnx
[INFO] 2026-06-15 11:43:46,802 [RapidOCR] base.py:22: Using engine_name: onnxruntime
[INFO] 2026-06-15 11:43:46,803 [RapidOCR] main.py:53: Using /opt/app-root/src/.cache/docling/models/RapidOcr/onnx/PP-OCRv4/rec/ch_PP-OCRv4_rec_infer.onnx
INFO:     Application startup complete.
INFO:     Uvicorn running on http://0.0.0.0:5001 (Press CTRL+C to quit)
INFO:     172.17.0.1:46378 - "GET /health HTTP/1.1" 200 OK
INFO:     172.17.0.1:46394 - "GET /health HTTP/1.1" 200 OK
WARNING:docling_core.types.doc.document:Parameter `strict_text` has been deprecated and will be ignored.
INFO:     172.17.0.1:46394 - "POST /v1/convert/source HTTP/1.1" 200 OK
INFO:     172.17.0.1:46394 - "POST /v1/convert/source HTTP/1.1" 200 OK
INFO:     172.17.0.1:46394 - "POST /v1/convert/source HTTP/1.1" 200 OK
INFO:     172.17.0.1:46394 - "GET /v1/clear/converters HTTP/1.1" 200 OK
INFO:     172.17.0.1:46394 - "GET /v1/clear/results?older_then=3600 HTTP/1.1" 200 OK

```

--------------------------------

### Test Specific Docling Serve Tags in Parallel

Source: https://github.com/docling-project/docling-java/blob/main/docs/src/doc/docs/testing.md

Run Docling version tests for a specified set of tags in parallel, controlling the number of concurrent tests. This example demonstrates overriding default parallelism and tag selection.

```bash
./gradlew :docling-version-tests:quarkusDev \
  -p 3 \
  -t v1.8.0 \
  -t v1.7.3 \
  -t v1.6.5
```