/linuxcnc-docker

Dockerfile for testing linuxcnc

Primary LanguageMakefileApache License 2.0Apache-2.0

Readme

This document covers the current state of the Docker built image. It enumerates the known issues, todo lists, etc...

Releases

See RELEASE.md for more details.

Basics

See the README.Docker.md for more information on basic operation using Docker.

Single Board Computers (SBC) like the Raspberry Pi and NVIDIA Jetson Nano are supported via Docker with specific guides located here.

Run

$ xhost +
$ docker run --rm -it -v /tmp/.X11-unix/X0:/tmp/.X11-unix/X0 -e DISPLAY=:0 jeffersonjhunt/linuxcnc start

Realtime OS Run

$ xhost +
$ docker run --rm -it --oom-kill-disable --cpu-rt-runtime=950000 --ulimit rtprio=99 --cap-add=sys_nice \
  -v /tmp/.X11-unix/X0:/tmp/.X11-unix/X0 -e DISPLAY=:0 jeffersonjhunt/linuxcnc start

Config & Control

Entrypoint script

The linuxcnc-entrypoint.sh is used to simplify the interaction of Docker with LinuxCNC. Docker passes in any additional arguments to the run command to the entrypoint.

Build Notes

Dockerfile

Structure

The Dockerfile is broken into several RUN sections to allow for quicker builds while adding and refining modules, plugins, supporting apps and new versions of LinuxCNC.

Build

See: BUILD.md for complete details on building, debugging and packaging.