Failed to start api_websocket

[bailiqun]

Self Checks

• I have read the Contributing Guide and Language Policy.
• This is only for bug report, if you would like to ask a question, please head to Discussions.
• I have searched for existing issues search for existing issues, including closed ones.
• I confirm that I am using English to submit this report, otherwise it will be closed.
• 【中文用户 & Non English User】请使用英语提交，否则会被关闭 ：）
• Please do not modify this template :) and fill in all the required fields.

Dify version

1.14.1

Cloud or Self Hosted

Self Hosted (Docker)

Steps to reproduce

docker compose up
all use default env files

✔️ Expected Behavior

use docker-compose up dify 1.14.1, api_websocket down

api_websocket-1 | api_websocket-1 | Error: class uri 'geventwebsocket.gunicorn.workers.GeventWebSocketWorker' invalid or not found: api_websocket-1 | api_websocket-1 | [Traceback (most recent call last): api_websocket-1 | File "/app/api/.venv/lib/python3.12/site-packages/gunicorn/util.py", line 110, in load_class api_websocket-1 | mod = importlib.import_module('.'.join(components)) api_websocket-1 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ api_websocket-1 | File "/usr/local/lib/python3.12/importlib/__init__.py", line 90, in import_module api_websocket-1 | return _bootstrap._gcd_import(name[level:], package, level) api_websocket-1 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ api_websocket-1 | File "<frozen importlib._bootstrap>", line 1387, in _gcd_import api_websocket-1 | File "<frozen importlib._bootstrap>", line 1360, in _find_and_load api_websocket-1 | File "<frozen importlib._bootstrap>", line 1310, in _find_and_load_unlocked api_websocket-1 | File "<frozen importlib._bootstrap>", line 488, in _call_with_frames_removed api_websocket-1 | File "<frozen importlib._bootstrap>", line 1387, in _gcd_import api_websocket-1 | File "<frozen importlib._bootstrap>", line 1360, in _find_and_load api_websocket-1 | File "<frozen importlib._bootstrap>", line 1310, in _find_and_load_unlocked api_websocket-1 | File "<frozen importlib._bootstrap>", line 488, in _call_with_frames_removed api_websocket-1 | File "<frozen importlib._bootstrap>", line 1387, in _gcd_import api_websocket-1 | File "<frozen importlib._bootstrap>", line 1360, in _find_and_load api_websocket-1 | File "<frozen importlib._bootstrap>", line 1324, in _find_and_load_unlocked api_websocket-1 | ModuleNotFoundError: No module named 'geventwebsocket' api_websocket-1 | ] api_websocket-1 | api_websocket-1 exited with code 0

❌ Actual Behavior

No response

[fatelei]

uv sync

[bailiqun]

It works now. Please update the production image as soon as possible.

[dosubot]

This error was also reported in 1.14.0-rc1 [1] and appears to be related to the new api_websocket service that was separated out in 1.14.1 [2].

The gevent-websocket package is declared as a dependency in pyproject.toml [3], so it should be present in the Docker image. A few things to check:

1. Make sure you're pulling the latest image — run docker compose pull to ensure you have the correct langgenius/dify-api:1.14.1 image. An older cached image might be missing the dependency.

2. The api_websocket service uses the collaboration profile [4]. If you're running it with just docker compose up without specifying the profile, the behavior may differ. Try:

   docker compose --profile collaboration up

3. Gunicorn was upgraded to 26.0.0 around the same time [5], which could potentially have compatibility issues with the gevent-websocket worker class.

If the issue persists after pulling the latest image, could you share the output of:

docker compose exec api_websocket pip list | grep gevent

This will confirm whether gevent-websocket is actually installed in your running container.

Written by @dosu, approved by crazywoola

To reply, just mention @dosu.

---

Docs are dead. Just use Dosu.