Utensils Docker Opengl Save
Multi-Arch Docker - Mesa 3D OpenGL Software Rendering (Gallium) - LLVMpipe, and OpenSWR Drivers
Multi-Arch Docker - Mesa 3D OpenGL Software Rendering (Gallium) - LLVMpipe, and OpenSWR Drivers
About
Minimal Docker container bundled with the Mesa 3D Gallium Drivers: LLVMpipe & OpenSWR, enabling OpenGL support inside a Docker container without the need for a GPU.
Features
- Alpine Linux 3.12
- LLVMpipe Driver (Mesa 20.0.6)
- OpenSWR Driver (Mesa 20.0.6)
- OSMesa Interface (Mesa 20.0.6)
- softpipe - Reference Gallium software driver
- swrast - Legacy Mesa software rasterizer
- Xvfb - X Virtual Frame Buffer
Docker Images
Please note there are images available for Alpine versions 3.10, 3.11 as well. Please see all available tags on DockerHub
| Image | Description | Architectures | Base Image |
|---|---|---|---|
utensils/opengl:latest |
Latest Mesa version | amd64, 386, arm64, arm/v7 | alpine:3.12 |
utensils/opengl:stable |
Stable Mesa version (Personally Tested) | amd64, 386, arm64, arm/v7 | alpine:3.12 |
utensils/opengl:20.0.6 |
Mesa version 20.0.6 | amd64, 386, arm64, arm/v7 | alpine:3.12 |
utensils/opengl:19.0.8 |
Mesa version 19.0.8 | amd64 | alpine:3.10 |
utensils/opengl:18.3.6 |
Mesa version 18.3.6 | amd64 | alpine:3.10 |
utensils/opengl:18.2.8 |
Mesa version 18.2.8 | amd64 | alpine:3.10 |
Building
This image can be built locally using the supplied Makefile
Make default image (stable):
make
Make latest image:
make latest
Make all images:
make all
Usage
This image is intended to be used as a base image to extend from. One good example of this is the Envisaged project which allows for quick and easy Gource visualizations from within a Docker container.
Extending from this image.
FROM utensils/opengl:20.0.6
COPY ./MyAppOpenGLApp /AnywhereMyHeartDesires
RUN apk add --update my-deps...
Environment Variables
The following environment variables are present to modify rendering options.
High level settings
| Variable | Default Value | Description |
|---|---|---|
XVFB_WHD |
1920x1080x24 |
Xvfb demensions and bit depth. |
DISPLAY |
:99 |
X Display number. |
LIBGL_ALWAYS_SOFTWARE |
1 |
Forces Mesa 3D to always use software rendering. |
GALLIUM_DRIVER |
llvmpipe |
Sets OpenGL Driver llvmpipe, swr, softpipe, and swrast |
Lower level settings / tweaks
| Variable | Default Value | Description |
|---|---|---|
LP_NO_RAST |
false |
LLVMpipe - If set LLVMpipe will no-op rasterization |
LP_DEBUG |
"" |
LLVMpipe - A comma-separated list of debug options is accepted |
LP_PERF |
"" |
LLVMpipe - A comma-separated list of options to selectively no-op various parts of the driver. |
LP_NUM_THREADS |
"" |
LLVMpipe - An integer indicating how many threads to use for rendering. Zero (0) turns off threading completely. The default value is the number of CPU cores present. |
Open Source Agenda Badge
