Headless Wine on Ubuntu 24.04. Optimized for Python and production-ready deployments.
415
A high-performance, containerized Windows Compatibility Layer designed for headless environments. This image provides a pre-configured Wine 11.0 (Stable) environment on an Ubuntu 24.04 (Noble Numbat) base.
WINEPREFIX is pre-initialized during the build phase. This skips the typical 10-15 second setup delay at runtime.Xvfb (X Virtual Framebuffer) to provide a virtual display, preventing crashes for .exe files that require a monitor.docker build -t wine-headless .
We use a version-pinned tagging strategy for maximum stability.
docker tag wine-headless sangamamtechnologies/wine:11.0-ubuntu-24.04
docker tag wine-headless sangamamtechnologies/wine:latest
docker login
docker push sangamamtechnologies/wine:11.0-ubuntu-24.04
Since this is a headless environment, you must wrap your wine calls with xvfb-run to provide a virtual display buffer.
To run a Windows executable located in your current directory on the host:
docker run -it --rm \
-v $(pwd):/app \
sangamamtechnologies/wine:11.0-ubuntu-24.04 xvfb-run --auto-servernum wine Z:\\app\\your_application.exe
docker run -it --rm -v $(pwd):/app sangamamtechnologies/wine:11.0-ubuntu-24.04 bash
# Once inside:
xvfb-run --auto-servernum wine /app/your_app.exe
| Variable | Value | Description |
|---|---|---|
WINEDEBUG | -all | Suppresses debugging logs for performance. |
DISPLAY | :99 | Routes GUI calls to the memory-based virtual screen. |
WINEPREFIX | /wine | The path for the virtual Windows filesystem. |
WINEDLLOVERRIDES | mscoree,mshtml=d | Prevents prompts to install Mono or Gecko. |
winebth (Bluetooth) service to prevent timeout hangs.wineboot command is executed during build to generate the registry ahead of time.XDG_RUNTIME_DIR to /tmp/runtime-root for Ubuntu 24.04 security.\\) when referencing Windows paths./ are accessed via Z:\. Internal Wine files are under C:\.Content type
Image
Digest
sha256:a86039ec2โฆ
Size
1.4 GB
Last updated
10 months ago
docker pull petaroid/wine