https://github.com/openscad/docker-openscad
OpenSCAD-related docker files
https://github.com/openscad/docker-openscad
Last synced: 3 months ago
JSON representation
OpenSCAD-related docker files
- Host: GitHub
- URL: https://github.com/openscad/docker-openscad
- Owner: openscad
- License: bsd-2-clause
- Created: 2017-09-11T03:16:06.000Z (over 7 years ago)
- Default Branch: main
- Last Pushed: 2023-12-20T14:33:06.000Z (over 1 year ago)
- Last Synced: 2024-05-01T09:42:36.275Z (about 1 year ago)
- Language: Dockerfile
- Size: 129 KB
- Stars: 10
- Watchers: 12
- Forks: 10
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# docker-openscad
This repository collects OpenSCAD related docker files. One is meant for running OpenSCAD in a container (for building models, etc.), while the rest are meant for internal use in the OpenSCAD CI automation.
## General Use
For general use (running OpenSCAD in a container), please use the `openscad/openscad` images published and documented at Docker Hub.
* [openscad/openscad](https://hub.docker.com/repository/docker/openscad/openscad)
### Rendering to a STL/3MF Model
```bash
docker run \
-it \
--rm \
-v $(pwd):/openscad \
-u $(id -u ${USER}):$(id -g ${USER}) \
openscad/openscad:latest \
openscad -o CSG.3mf CSG.scad
```
### Rendering a PNG
```bash
docker run \
-it \
--rm \
--init \
-v $(pwd):/openscad \
-u $(id -u ${USER}):$(id -g ${USER}) \
openscad/openscad:latest \
xvfb-run -a openscad -o CSG.png CSG.scad
```
Note that PNG renderings currently still needs the X display. That limitation can go away soon due to the built-in EGL support. So this needs `--init` and run via `xvfb-run`.
## CI support, for internal use
* `openscad/appimage-*`
* `openscad/mxe-*`
* `openscad/src-*`
All docker images can be viewed with a [Docker Hub search for `openscad/`](https://hub.docker.com/search?q=openscad%2F&image_filter=open_source&type=image).
## Debug Builds
Creating an image with debug symbols depends if the app is compiled with `cmake` or `qmake`. To enable debugging set `BUILD_TYPE="Debug"` and `DEBUG="+"` in `scripts/build-images.sh
Before
```bash
--build-arg BUILD_TYPE="Release" \
--build-arg DEBUG="-" \
```
After
```bash
--build-arg BUILD_TYPE="Debug" \
--build-arg DEBUG="+" \
```
Example to run gdb in a container
```bash
docker run --ulimit core=-1 -it -v $(pwd):/input openscad/openscad:2021.01-debug
apt update; apt install gdb -y
xvfb-run gdb --ex run --args openscad --info
```