OctoPrint

This is a Dockerfile to set up OctoPrint. It supports the following architectures automatically:

• x86
• arm32v6 ¹
• arm32v7
• arm64

Just run:

docker run nunofgs/octoprint

Now have a beer, you did it. 🍻

Tags

• 1.4.0, 1.4.0-debian, debian, latest (Dockerfile)
• 1.4.0-alpine, alpine (Dockerfile)
• 1.3.12, 1.3.12-debian (Dockerfile)
• 1.3.12-alpine (Dockerfile)
• 1.3.11, 1.3.11-debian (Dockerfile)
• 1.3.11-alpine (Dockerfile)
• 1.3.10 (Dockerfile)
• 1.3.9 (Dockerfile)
• 1.3.8 (Dockerfile)
• 1.3.7 (Dockerfile)
• 1.3.6 (Dockerfile)
• master-debian, master (Automatically built daily from OctoPrint's master branch)
• master-alpine (Automatically built daily from OctoPrint's master branch)

Tested devices

Please let me know if you test any others, would love to increase the compatibility list!

Usage

$ docker run \
  --device=/dev/video0 \
  -p 80:80 \
  -v /mnt/data:/data \
  nunofgs/octoprint

Environment Variables

CuraEngine integration

Cura engine integration was very outdated (using version 15.04.6) and was removed.

It will return once OctoPrint supports python3 (needed for the newest versions of cura engine).

Webcam integration

USB Webcam

1. Bind the camera to the docker using --device=/dev/video0:/dev/videoX
2. Optionally, change MJPEG_STREAMER_INPUT to your preferred settings (ex: input_uvc.so -y -n -r 1280x720 -f 10)

Raspberry Pi camera module

1. The camera module must be activated (sudo raspi-config -> interfacing -> Camera -> set it to YES)
2. Memory split must be at least 128mb, 256mb recommended. (sudo raspi-config -> Advanced Options -> Memory Split -> set it to 128 or 256)
3. You must allow access to device: /dev/vchiq
4. Change MJPEG_STREAMER_INPUT to use input_raspicam.so (ex: input_raspicam.so -fps 25)

^{* Raspberry PI camera support is only available in arm/v6 and arm/v7 builds at the moment.}

Octoprint configuration

Use the following settings in octoprint:

webcam:
  stream: /webcam/?action=stream
  snapshot: http://127.0.0.1:8080/?action=snapshot
  ffmpeg: /usr/bin/ffmpeg

Notes

Distro variants

There are currently alpine and debian variants available of this image. At time of writing, here are their sizes:

While SD cards are pretty cheap these days, a smaller image is always preferrable so feel free to submit PRs that reduce the image size without affecting functionality!

ARMv6 Docker Bug

ARM32v6 devices such as the Raspberry Pi Zero (W) are unfortunately unable to pull this image directly using docker pull nunofgs/octoprint due to a bug in Docker (moby/moby#37647, moby/moby#34875). There's a PR open to fix this but it might be some time until it hits a stable Docker release.

Until then, you can run this container by specifying the armv6 image hash. Example on HypriotOS 1.11.0:

$ docker manifest inspect nunofgs/octoprint | grep -e "variant.*v6" -B 4

# copy sha256 hash of the v6 image you want to run.

$ docker run nunofgs/octoprint@sha256:dce9b67ccd25bb63c3024ab96c55428281d8c3955c95c7b5133807133863da29

Toggle the camera on/off

This image uses supervisord in order to launch 3 processes: haproxy, octoprint and mjpeg-streamer.

This means you can disable/enable the camera at will from within octoprint by editing your config.yaml:

system:
  actions:
  - action: streamon
    command: supervisorctl start mjpeg-streamer
    confirm: false
    name: Start webcam
  - action: streamoff
    command: supervisorctl stop mjpeg-streamer
    confirm: false
    name: Stop webcam

Credits

Original credits go to https://bitbucket.org/a2z-team/docker-octoprint. I initially ported this to the raspberry pi 2 and later moved to a multiarch image.

License

MIT