[Bug] Document parsing fails in Knowledge Base despite valid embedding model configuration - [Errno 111] Connection refused

[midilandlu]

RAGFlow Version -
v0.23.1

Issue Description
I have successfully configured the embedding model and verified that the model provider's embedding service is functioning correctly outside of this context.

However, when attempting to perform document parsing in the Knowledge Base, the process fails and an error screen is displayed.

Logs
The log file information is as follows:

    if langfuse.auth_check():

       ^^^^^^^^^^^^^^^^^^^^^

  File "/ragflow/.venv/lib/python3.12/site-packages/langfuse/_client/client.py", line 3232, in auth_check

    projects = self.api.projects.get()

               ^^^^^^^^^^^^^^^^^^^^^^^

  File "/ragflow/.venv/lib/python3.12/site-packages/langfuse/api/resources/projects/client.py", line 60, in get

    _response = self._client_wrapper.httpx_client.request(

                ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

  File "/ragflow/.venv/lib/python3.12/site-packages/langfuse/api/core/http_client.py", line 207, in request

    response = self.httpx_client.request(

               ^^^^^^^^^^^^^^^^^^^^^^^^^^

  File "/ragflow/.venv/lib/python3.12/site-packages/httpx/_client.py", line 825, in request

    return self.send(request, auth=auth, follow_redirects=follow_redirects)

           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

  File "/ragflow/.venv/lib/python3.12/site-packages/httpx/_client.py", line 914, in send

    response = self._send_handling_auth(

               ^^^^^^^^^^^^^^^^^^^^^^^^^

  File "/ragflow/.venv/lib/python3.12/site-packages/httpx/_client.py", line 942, in _send_handling_auth

    response = self._send_handling_redirects(

               ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

  File "/ragflow/.venv/lib/python3.12/site-packages/httpx/_client.py", line 979, in _send_handling_redirects

    response = self._send_single_request(request)

               ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

  File "/ragflow/.venv/lib/python3.12/site-packages/httpx/_client.py", line 1014, in _send_single_request

    response = transport.handle_request(request)

               ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

  File "/ragflow/.venv/lib/python3.12/site-packages/httpx/_transports/default.py", line 249, in handle_request

    with map_httpcore_exceptions():

  File "/usr/lib/python3.12/contextlib.py", line 158, in __exit__

    self.gen.throw(value)

  File "/ragflow/.venv/lib/python3.12/site-packages/httpx/_transports/default.py", line 118, in map_httpcore_exceptions

    raise mapped_exc(message) from exc

httpx.ConnectError: [Errno 111] Connection refused

[2026-01-14 18:04:56 +0800] [73] [INFO] 127.0.0.1:34860 POST /v1/document/list 1.1 200 1777 9841

[2026-01-14 18:04:56 +0800] [73] [INFO] 127.0.0.1:34864 GET /v1/kb/detail 1.1 200 1657 9557

[dosubot]

The error is caused by RAGFlow trying to connect to Langfuse, but the connection is refused—this blocks document parsing before the embedding model is used. Langfuse is configured per tenant, and RAGFlow validates connectivity by calling auth_check() on the Langfuse client. If the Langfuse host is unreachable (not running, wrong host/port, or blocked by firewall/network), you'll see this error and document parsing will fail source.

To fix this:

• Check your Langfuse configuration (host, port, public_key, secret_key) in the RAGFlow UI or config files and confirm if Langfuse is intentionally enabled for your tenant.
• Test connectivity from your RAGFlow environment (container or host) to the Langfuse host/port (for example, with curl or telnet).
• If you need Langfuse, make sure the service is running, listening on the correct interface (0.0.0.0), and accessible from RAGFlow. Update firewall or Docker network settings if needed source.
• If you don't need Langfuse, remove or disable its configuration for your tenant so RAGFlow doesn't try to connect during document parsing.
• After making changes, restart RAGFlow and related services to apply the new configuration.

If the issue persists, check logs for any new errors and confirm all config files are mounted and up to date source.

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}

   

[midilandlu]

@dosu
I disable Langfuse configuration and restart RAGFlow , It work now, thanks

[dosubot]

You're welcome! Glad to hear it's working now. If you run into any more issues or have questions about RAGFlow features or configuration, just let me know.

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}