Sign inSign up
wine logo

petaroid/wine

By petaroid

โ€ขUpdated 10 months ago

Headless Wine on Ubuntu 24.04. Optimized for Python and production-ready deployments.

Image
Developer tools
Operating systems
0

415

petaroid/wine repository overview

โ Wine-Headless-Runner

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.

โ ๐Ÿš€ Why This Image?

  • Instant Start: The WINEPREFIX is pre-initialized during the build phase. This skips the typical 10-15 second setup delay at runtime.
  • Headless Optimized: Uses Xvfb (X Virtual Framebuffer) to provide a virtual display, preventing crashes for .exe files that require a monitor.
  • Noise-Free Logs: Environment variables are tuned to silence non-fatal OLE, Bluetooth, and "Fixme" errors.
  • Modern WoW64: Leverages Wine 11.0's improved architecture for compatibility with modern 64-bit software.

โ ๐Ÿ› ๏ธ Build and Distribution

โ 1. Build the Image Locally
docker build -t wine-headless .
โ 2. Tag for Docker Hub

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
โ 3. Push to Docker Hub
docker login
docker push sangamamtechnologies/wine:11.0-ubuntu-24.04

โ ๐Ÿƒ Execution Instructions

Since this is a headless environment, you must wrap your wine calls with xvfb-run to provide a virtual display buffer.

โ 1. Run a Local .exe (Mounting from Host)

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
โ 2. Interactive Debugging
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

โ โš™๏ธ Environment Configuration

VariableValueDescription
WINEDEBUG-allSuppresses debugging logs for performance.
DISPLAY:99Routes GUI calls to the memory-based virtual screen.
WINEPREFIX/wineThe path for the virtual Windows filesystem.
WINEDLLOVERRIDESmscoree,mshtml=dPrevents prompts to install Mono or Gecko.

โ ๐Ÿงช Technical Optimizations

  • Registry Tweaks: Includes a patch to disable the winebth (Bluetooth) service to prevent timeout hangs.
  • Warm Booting: The wineboot command is executed during build to generate the registry ahead of time.
  • XDG Compliance: Configures XDG_RUNTIME_DIR to /tmp/runtime-root for Ubuntu 24.04 security.

โ โš ๏ธ Troubleshooting

  • Pathing Errors: Use double backslashes (\\) when referencing Windows paths.
  • Z: Drive vs C: Drive: Files at the Linux root / are accessed via Z:\. Internal Wine files are under C:\.

Tag summary

Content type

Image

Digest

sha256:a86039ec2โ€ฆ

Size

1.4 GB

Last updated

10 months ago

docker pull petaroid/wine