Zum Hauptinhalt wechseln


This guide is still a WIP. The Arduino + NeoPixels are not compatible with Klipper as is. Instead Pawel Drylenko has developed a script that runs on the Pi. This guide is missing the wiring diagrams and setup files for the NeoPixels as well as the custom Mainsail theme from Ben Levi. This guide will be fully completed within the next few days.

There are a number of methods to install Klipper. After a number of botched installs I found this method to be the most consistent and easiest.

You can use virtually any RPI model but it’s recommended to use Raspberry Pi 4. You’ll need at least a Class-10 8gb SD card. If a UHS(Ultra High Speed) is available, you’ll want at least a UHS-1.

For my setup I’m using a Raspberry Pi 4 8GB and a SanDisk 64GB USB3.1 Flash Drive.

I’m using a Raspberry Pi4 8GB because I had a spare one laying around and I wanted to be able to connect to 5G wifi.

I’ve also chosen to use a flash drive instead of a SD card because the date transfer rate is 3-4x faster.

I’m powering the RPI with a Raspberry Pi Foundation approved power adapter

Project Link


  1. Klipper+Mainsail Install, Download/Setup: Schritt 1, Bild 1 von 2 Klipper+Mainsail Install, Download/Setup: Schritt 1, Bild 2 von 2
    • Download and extract the latest version of Mainsail from their Github

    • Open the Raspberry Pi Imager

    • Select Operating System > Use custom > Select the Mainsail OS you downloaded.

    • Select Storage > Select your SD.

    • Bring up the Advanced Settings menu by pressing "Ctrl + Shift + X".

    • Here you can setup your WiFi, locale, enable SSH and numerous other options.

    • Write > Yes to confirm

    • After imaging is complete the SD is automatically ejected. Insert it into the RPI and power it on.

  2. Klipper+Mainsail Install, Configuring Mainsail: Schritt 2, Bild 1 von 2 Klipper+Mainsail Install, Configuring Mainsail: Schritt 2, Bild 2 von 2
    • With the Raspberry Pi connected to the Duet 2 WiFi via USB, power on the RPI and SSH into the Pi.

    • You can find the IP address of the Pi by looking at the connected client list in your router or by opening cmd.exe on your PC and running

    • ping mainsailos.local -4

    • In a webpage enter http://mainsailos.local or your printers IP address

    • Navigate to the Machine tab on the left.

    • Select Upgrade to update the RPI image and Update to install updates for Klipper, Mainsail and Moonraker. Once the updates are complete reboot the RPI

  3. Klipper+Mainsail Install, Factory Reset Duet 2 WiFi: Schritt 3, Bild 1 von 1
    • Originally when I wrote this guide I saw many sources say you do not need to manually erase the firmware when you configure the Duet 2 WiFi for Klipper for the first time. However there's been many cases that has proven false.

    • With the board powered off place a jumper on the erase pins.

    • Connect the USB cable from the Duet 2 WiFi to a 5v power source(your PCs USB Port).

    • Once the diag light comes on remove the jumper

    • Any firmware saved to the Duet has been erased.

  4. Klipper+Mainsail Install, Flash Duet 2 WiFi 1: Schritt 4, Bild 1 von 1
    • Connect the Duet 2 WiFi to the Pi with a USB cable. Power on the Pi and SSH into it.

    • cd klipper

    • make clean

    • make menuconfig

    • Micro-Controller > SAM3/SAM4 (Due and Duet)

    • Processor > SAM4e8e (Duet WiFi/Eth)

    • Communication Interface > USB

    • Press the escape key on your keyboard and enter Y to save the config

  5. Klipper+Mainsail Install, Flash Duet 2 WiFi 2: Schritt 5, Bild 1 von 2 Klipper+Mainsail Install, Flash Duet 2 WiFi 2: Schritt 5, Bild 2 von 2
    • Enter make

    • Stop the Klipper service.

    • sudo service klipper stop

    • Get the Duet's serial ID # and copy it down.

    • ls /dev/serial/by-id/*

    • Enter "make flash FLASH_DEVICE=" and paste your serial after the =

    • If the flash fails 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

    • Enter make "flash FLASH_DEVICE=" and paste your serial your new serial after the =

  6. Klipper+Mainsail Install, Flash Linux CPU 1: Schritt 6, Bild 1 von 1
    • Make sure you're in the klipper directory

    • cd ~/klipper/

    • Enter the following commands

    • sudo cp "./scripts/klipper-mcu-start.sh" /etc/init.d/klipper_mcu

    • sudo update-rc.d klipper_mcu defaults

    • make clean

    • make menuconfig

  7. Klipper+Mainsail Install, Flash Linux CPU 2: Schritt 7, Bild 1 von 3 Klipper+Mainsail Install, Flash Linux CPU 2: Schritt 7, Bild 2 von 3 Klipper+Mainsail Install, Flash Linux CPU 2: Schritt 7, Bild 3 von 3
    • Micro-Controller Architecture > Linux Process. Press esc than Y

    • make

    • make flash

    • sudo service klipper start

    • Verify klipper_host_mcu is in the tmp directory with ls /tmp/*

    • Add the pi to the TTY group

    • sudo usermod -a -G tty pi

    • sudo reboot -h now

  8. Klipper+Mainsail Install, Loading Config: Schritt 8, Bild 1 von 1
    • Next we will go to a Web browser to the Pi's IP address. You will see an error for "Unable to open config file /home/pi/klipper_config/printer.cfg"

    • Download the printer.cfg file from blvprojects.com and upload it to the config directory

    • Open your newly created "printer.cfg". Scroll down to line 169. Make sure you update the config with your serial ID you got from "ls /dev/serial/by-id/*"

    • Double check the mcu rpi serial ID in line 181 maches "ls /tmp/*"

    • Click SAVE and restart the printer

  9. Klipper+Mainsail Install, Optional-Configure PS_ON: Schritt 9, Bild 1 von 1
    • If you use a separate 5v PSU for PS_ON You'll need to add the following lines

    • [output_pin psupower] pin: PD15

    • [gcode_macro M80] gcode: SET_PIN PIN=psupower VALUE=1

    • [gcode_macro M81] gcode: SET_PIN PIN=psupower VALUE=0

  10. Klipper+Mainsail Install, PanelDue 1: Schritt 10, Bild 1 von 1
    • PanelDue is compatible with Klipper but only with v1.24. Instructions can be found here

    • Connect the PanelDue to the RPI.

    • 5v > 5v

    • GND > GND

    • UART0 TX > DIN

    • UART0 RX > DOut

  11. Klipper+Mainsail Install, PanelDue Configuration 2: Schritt 11, Bild 1 von 1
    • SSH into the RPI.

    • sudo nano /boot/config.txt

    • At the bottom of the config file enter:

    • dtoverlay=pi3-miniuart-bt

    • Press Ctrl+X > Y to save > Enter to accept

  12. Klipper+Mainsail Install, PanelDue Configuration 3: Schritt 12, Bild 1 von 1
    • We need to disable the serial console

    • sudo nano /boot/cmdline.txt

    • Remove the following string

    • console=serial0,115200

    • Press Ctrl+X > Y to save > Enter to accept

  13. Klipper+Mainsail Install, PanelDue Configuration 4: Schritt 13, Bild 1 von 1
    • Disable serial console

    • Sudo raspi-config

    • 3 Interface Options > P6 Serial Port > No > Yes

    • Yes to reboot the RPI

    • Make sure you change the baud rate on the paneldue to 115200

    • There's also a number of configs that need to be added to your moonraker.cfg. Those details can be found here.

  14. Klipper+Mainsail Install, BLV Mainsail Theme: Schritt 14, Bild 1 von 3 Klipper+Mainsail Install, BLV Mainsail Theme: Schritt 14, Bild 2 von 3 Klipper+Mainsail Install, BLV Mainsail Theme: Schritt 14, Bild 3 von 3
    • Download the file and extract.

    • Under "machine" menu, click on the Gear icon and select the checkbox for "show hidden files".

    • Select "Create Directory".

    • In the name field enter “.theme” and select CREATE.

    • it has to be named as seen in the screenshot.

    • Select the newly created ".theme" folder. Upload all the files from the zip archive into .theme folder.

    • hit Ctrl+F5 and Enjoy.


I wasn’t paid to write these guides. Ben asked me to do it as a favor to him. Considering all that he’s done for our community I felt it was the least I could do. To be honest even though it took about 2 months to build and document, I had a lot of fun doing it. It forced me to write guides in a manner that was easy for everyone to understand and cleanup my Github so I could share any files that were used that aren’t part of the original download. You’re not obligated but if you would like, feel free to donate.

2 weitere Nutzer haben diese Anleitung absolviert.

David Husolo

Mitglied seit: 16.06.2021

6.647 Reputation

28 Anleitungen geschrieben

0 Kommentare

Kommentar hinzufügen


Letzten 24 Stunden: 50

Letzten 7 Tage: 340

Letzten 30 Tage: 1,403

Insgesamt: 6,714