Posted on 5 Comments

HELP, Klipper update broke my install!

This is a quick guide to show how to fix your install, if a new update caused a version mismatch.

There are pretty standard guides, but most leave out that with input shaping and other advanced features, we have to also compile the microcode for the host controller, a raspberry pi in most cases. I may be adding a guide to use a tablet as the Klipper host in future, so that we could use an old tablet to control the printer, and just use the Duet spi bus, so we could mount a nice big tablet or old laptop, etc, onto the printer and have it complete standalone. Below is a list of commands to use for anyone feeling a little overwhelmed, but it’s much cleaner to follow this video.


  • To enter a previously entered command, press on your keyboard. You can cycle between options with and
  • To copy text inside a PuTTY terminal, just select it.
  • To paste, right click


  1. Open PuTTY, and connect to the raspberry pi with your IP address. (mac can use the ssh command)
  2. Login to your pi, default is pi and raspberry
  3. Enter cd klipper
  4. Enter make clean
  5. Enter make menuconfig
  6. Select Micro-controller Architecture
  7. Select SAM3/SAM4 (Due and Duet)
  8. Select SAM4e8e (Duet Wifi/Eth) inside Processor Model
  9. Ensure that (USB) is selected inside Communication interface
  10. Press Esc then Y
  11. Enter make
  12. Enter sudo service klipper stop, enter your password
  13. Enter ls /dev/serial/by-id/*
  14. Copy the serial by just selecting it in the window
  15. Enter make flash FLASH_DEVICE= and paste your serial after the =
  16. Note their is a chance that flash may fail and usually this will place the board into a bootloader mode like original install does when you hit the erase pins. If this occurs please rerun ls /dev/serial/by-id/* so that you can get the correct serial and use this one repeating step 10
  17. Enter make clean
  18. Enter make menuconfig
  19. Select linux process inside Micro-controller Architecture press Esc then Y
  20. Enter make
  21. Enter make flash, enter your password
  22. Restart the klipper service in the mainsail interface

5 thoughts on “HELP, Klipper update broke my install!

  1. That did not work for me. I had to select Linux as the MCU.

    1. The video said to do it again i just summarized the instructions but ill add it to the written part to

  2. also not work for me. skr mini v2

    1. This is for a duet wifi board. You can use the same guide but will have to pick your mcu settings.

  3. Quick note in case it helps others. If, after doing this procedure, you get errors about connecting because the serial port is missing and the command “ls /dev/serial/by-id/*” doesn’t work, you’ll want to reset the mcu according to page 12 in this document:

    Thanks Rob!

Leave a Reply

Your email address will not be published. Required fields are marked *