spuder/openscad

🛑 spuder/openscad has been replaced by openscad/openscad

docker pull openscad/openscad:2021.01

Openscad has started offering official openscad docker images. Use those instead. https://hub.docker.com/repository/docker/openscad/openscad

https://hub.docker.com/repository/docker/openscad/openscad

Legacy

A docker image containing a fairly recent version of openscad installed. (Newer than what is currently available in apt repos)

Usage

Basic example to print --version

docker pull spuder/openscad:2021.01
docker run -it spuder/openscad:2021.01 openscad --version
OpenSCAD version 2021.01

Basic example to Convert STL to PNG

docker run -it -v $(PWD):/data spuder/openscad:2021.01 openscad /dev/null -D "import(\"/data/cube.stl\");" -o "/data/cube.png" --imgsize=600,600 --colorscheme "Tomorrow Night"

Building from source

FAQ

:question: Why make this container? Doesn't openscad provide official container images?

The openscad images are for pipelines, not for actually running openscad

Additional Context

Releasing A new version

To upgrade the version that is deployed.

The files are downloaded from https://files.openscad.org/ Check that URL for available versions.

1. Modify OPENSCAD_VERSION in .github/workflows/dockerhub.yaml

          build-args: |
            OPENSCAD_VERSION=2021.01

2. Commit & create git tag

   git tag 2021.01

3. Push tags

4. Create release in github release page

5. Watch github actions deploy.

Limitations

This container is only intended for command line usage of openscad (e.g. in a CI/CD pipeline or scripts to manipulate STL files). Running a full QT/X11 environment from docker is probably possible, but is outside the scope of this repo. (If you have the skills to get it working, pull request welcome github.com/spuder/openscad).

Additional Resources

https://github.com/openscad/openscad/issues/1798#issuecomment-997619408