satitchula-printfarm
/
octoprint-klipper-docker
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
Docker image for running OctoPrint and Klipper in a single container
61 Commits 3 Branches 0 Tags 159 KiB
Dockerfile 53.3%
Python 28.5%
Shell 15.3%
G-code 2.9%
Go to file
seanauff 405b8f4b55
Update README.md 		2020-09-15 12:39:19 -04:00
build_scripts add push to script 2020-07-08 14:00:48 -04:00
Dockerfile change octoklipper plugin to new maintainer 2020-09-15 12:35:37 -04:00
LICENSE Initial commit 2018-06-04 08:03:11 +10:00
README.md Update README.md 2020-09-15 12:39:19 -04:00
docker-compose.yaml add container name 2020-05-31 14:55:21 -04:00
klippy.sudoers Initial commit 2018-06-04 08:27:11 +10:00
klippyoctostart.py Add a basic Klipper and OctoPrint Dockerfile 2018-06-07 22:57:30 +10:00
runklipper.py Number of updates to support latest versions 2019-03-30 23:04:02 +10:00
start.py Number of updates to support latest versions 2019-03-30 23:04:02 +10:00

README.md

OctoPrint-Klipper

My version of a Docker image for running OctoPrint and Klipper in a single container. Includes a few plugins I find useful.

Big thanks to sillyfrog for laying the groundwork for this image.

This is very much written for my purposes, so you'll likely need to modify it for your setup. I've been using it for a while now and it's going well. I've successfully run it on these platforms:

  • Orange Pi Zero 512MB
  • AtomicPi
  • Raspberry Pi 4B 1GB (current source of arm images)

Running the container

Create a directory on your host that will persist config files. I use /home/docker/octoprint-klipper.

Pull the image. Until I figure out multi platform aware images, you need to specify your arch. Both arm and amd64 images are on DockerHub. If using Raspberry Pi or similar use arm in place of [tag].

docker pull seanauff/octoprint-klipper:[tag]

Start the container once to populate your config folder:

docker run -d --name octoprint-klipper -e TZ=America/New_York -v /home/docker/octoprint-klipper:/home/octoprint/.octoprint --device /dev/ttyUSB0:/dev/ttyUSB0 -p 5000:5000 seanauff/octoprint-klipper:[tag]

Stop the container, and modify your Klipper printer.cfg and Octoprint config.yaml in the config directory as needed.

Restart the container.

A sample docker-compose file is also provided.

If you have any questions, feel free to log an issue on this project, and I'll see if I can help.

Updates

The easiest way to update is to pull the latest image and recreate the container. You could also build the image yourself to get the latest updates. I have had success in using the Octoprint built in updater to upgrade plugins, as well as install new ones. Any upgrades conducted in this manner will be lost upon recreation of the container.

Build the image yourself

The DockerHub images may not be as up to date as the repo (amd64 is autobuilt, but not arm), so you can ensure you have the latest by building yourself.

Clone the repository and build the image:

git clone https://github.com/seanauff/OctoPrint-Klipper.git
docker build -t seanauff/octoprint-klipper OctoPrint-Klipper

If you already have an image built and are trying to upgrade, you may need to force the build not to use cache:

docker build -t seanauff/octoprint-klipper --no-cache -pull OctoPrint-Klipper