mirror of
https://github.com/open-webui/open-webui.git
synced 2026-03-09 23:35:09 -05:00
issue: Docker MSWindows NVIDIA host default config apparent incompatibility. #5378
Reference in New Issue
Block a user
Delete Branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Originally created by @mirage335 on GitHub (May 29, 2025).
Check Existing Issues
Installation Method
Docker
Open WebUI Version
v0.6.12 - 2025-05-29
Ollama Version (if applicable)
No response
Operating System
MSWindows 11
Browser (if applicable)
No response
Confirmation
README.md.Expected Behavior
Starts OpenWebUI Docker container.
Actual Behavior
Fails to start OpenWebUI Docker container until the WSL2 distribution hosting Docker is reconfigured.
Steps to Reproduce
Install OpenWebUI Docker container with command to use NVIDIA stuff. Run Docker OpenWebUI container.
Logs & Screenshots
Additional Information
Please see this linked PDF file for full details, including all version numbers, detailed explanations of the underlying issue with NVIDIA, Docker, etc, workaround, etc, links to relevant web pages, etc.
https://github.com/mirage335-special/kit-researchEngine/blob/main/kit/_ref/Why%20the%20open-webui_cuda%20Container%20Fails%20to%20Start%20WSL2%20GPU%20Issue.pdf
The actual workaround itself is simple. Two shell commands on the host should suffice. However, this may or may not be applicable to Linux hosts, and the issue initially occurred with OpenWebUI v0.6.11 Docker container (the v0.6.12 version released the same hour I was diagnosing this, by the time that was installed, I had already applied the workaround).
358854ab7d (diff-f95584720e74ef817cb365a86278305f1924fca503f7c69d61427bc5b6d0dc40R756)If possible, it might be nice if the OpenWebUI Docker container could implement some configuration change to address this issue. If not, this may need escalation to Docker, NVIDIA, etc.
Improving stability is important, this just happened to me AFAIK before any upgrades of OpenWebUI, Docker, NVIDIA drivers, etc, so I'm not sure I could have been ready for such downtime.
By the way, yes I do override the entrypoint with a custom shell script . Not necessarily related to this bug, but please do not break that if possible.
https://github.com/mirage335-special/kit-researchEngine/blob/main/kit/researchEngine.sh#L773
@mirage335 commented on GitHub (May 29, 2025):
Then again, this gets worse. There is no way to make the workaround persist, effective on computer reboot.
Directives in '%USERPROFILE%.wslconfig' and '/etc/wsl.conf' directives do persist and take effect if 'wsl --shutdown' and 'wsl -d docker-desktop sysctl -a | grep 'bpf_jit_harden' commands are given. However, on computer reboot, seems Docker Desktop starts this 'docker-desktop' WSL2 instance in such a way that these commands either do not take effect or are not yet acted on. The docker-desktop sysctl -a | grep 'bpf_jit_harden' again shows the maximum hardening value of '2' which is incompatible with the OpenWebUI Docker container using NVIDIA drivers.
I guess the workaround is really to just not use containers with NVIDIA (ie. using the generic OpenWebUI Docker container without NVIDIA support).