dimo414/openscad repository overview

⁠OpenSCAD Docker Image

⁠

Installs openscad and a few dependencies useful dependencies. Notably, Xvfb is installed to work around a known limitation⁠ that PNG generation requires a running X server. This is how OpenSCAD tests PNG rendering⁠.

The easiest way to run Xvfb is via xvfb-run⁠, like so:

$ docker run -v $PWD:/mnt dimo414/openscad xvfb-run openscad -o /mnt/render.png /mnt/example.scad

Most other invocations to openscad don't require an X server and therefore can be run without xvfb-run (though doing so is fairly harmless):

$ docker run -v $PWD:/mnt dimo414/openscad openscad -o /mnt/render.stl /mnt/example.scad

⁠Alternatives

Although OpenSCAD uses Docker for CI, there are presently no official user-facing images⁠. It's straightforward to create a custom image with apt-get install openscad (or similar), but this does not support PNGs or other invocations that require an X server.

There are other unofficial images such as bbassett/openscad⁠ and wtnb75/openscad⁠ however neither appears to support running an X server.