Tutorial: Orange Pi Zero Plus Klipper Install

The Orange Pi Zero Plus is one of many open source single board computers (SBC) that have sprouted up over the last few years due to Raspberry Pi popularity and in more recent time shortages. The Orange Pi Zero isn’t a direct clone of the Pi Zero as it uses a different form factor and CPU. The later point there being very important because right now the CPU family used in the Raspberry Pi product lines is near impossible to source.

Because people are struggling to get hold of Raspberry Pi’s I’ve seen a big demand in alternative cheap SBC sources. I have also seen a lot of questions arising on whether or not it’s possible to install Klipper on it. Well today I’m going to answer that question and take you through the process.


The Orange Pi has clearly been designed as a direct competitor to the pi zero 2 W however the RRP is almost double at around £20. That said that is much less than the currently inflated prices I’ve seen for official Raspberry Pi’s



The Orange Pi comes in a small cardboard box with some instructions and no accessories. The board was in a sealed antistatic bag as is expected with most circuit boards.

First impressions are that the board is tiny! It measures in at 5cm*5cm*2cm. The price it pays for this small size is the lack of HDMI and only 1 USB A connection. Soldering quality looks good on both top and bottom layers, as does the silk screen. There is an external WiFi antenna which will hopefully mean a good WiFi connection!

Setting up the OS

Head over to the Armbian website and download the OS image for the Orange Pi Zero Plus, I recommend picking the Jammy variant as it is the latest release at the time of writing this guide. (linked directly here).

While you are at it now is probably a good time to download the user manual from here. I will try to make this guide as complete as possible but it can’t hurt to know where to find the official manual!

To write the OS image to the card I like to use the Raspberry Pi imager. Open the OS image in the Raspberry Pi imager and then select the SD card. Note – The SD card should be formatted with FAT32. Click write and then yes to acknowledge that any existing data on the SD card will be wiped.

Wait for the image to write to the SD card. This can take quite a while so grab a cup of tea or do whatever else you do to pass the time.

Insert the Micro SD card into the board and then connect via the micro usb to your PC. After a few moments you should see a solid green LED and a flashing red one.

You should get a notification saying a COM port has been connected. If you missed it open up device manager and locate which port the device connected at. It will be listed as a USB serial device. In my case this was COM5.

Open putty. Swap to Serial mode and then select the COM port you identified previously. Set the baud rate to 115200. Optionally add a name and save the settings for easy connection later on. Then click open to start the connection.

You should be greeted with a command line interface prompting you to add a root password. Enter your password then press enter. Repeat your password and hit enter again. (Note don’t be too lazy like I was and pick something too simple for the password!) enter 1 to choose Bash as your interface. Then enter a username and password for the normal user account.

You will be prompted to connect to the internet via WiFi (unless you had plugged in an ethernet connection and internet was automatically detected). Selected Y and you should see the following dialog with a list of WiFi networks discovered. Pick your network and enter the password to join the network. An Asterix * will appear next to the network if it connected. Quite this dialog once happy.

Type Y then enter to select a locale and language. If you are reading this you probably want to look out for EN. Enter your choice and wait – this step took my board a minute or two to complete.

Congratulations your SBC is up and running!

Installing Klipper

We will be using KIAUH to install Klipper and the associated packages.

First off we need to make sure git is installed. Paste and run the following command. It should already be there but there is no harm in checking!

sudo apt-get install git -y

Next we want to make sure we are using the user we created earlier rather than doing everything as root. I called my user pi. Run the command below but substitute in your user in the place of pi. You should see the active user change to the one you entered.

su pi

Next install KIAUH. run these command one at a time. You should now have successfully installed KIAUH.

cd ~

git clone https://github.com/th33xitus/kiauh.git

Next launch KIAUH using the command below. You should be greeted with the menu for installing Klipper, Mainsail and Moonraker!


Press 1 and enter to go to the install menu. We are going to work our way through the installed in numerical order. Start with Klipper (1) then Moonraker (2) then Mainsail (3). If you are familiar with this process and know what you want you can start adding extras but otherwise you can add them later. You will likely be prompted for the sudo password during this. Enter it (note no text appears when doing so) and press enter. Installing these will take a while. Choose y for all the options as you go along.

Once complete enter b to go back to the main menu. You should have a status that looks like this. If you do press q and exit.

Next we need to find the ip address for the device. Enter ifconfig and them look for wlan in the printout. The IP address we are interested in should be listed as inet. Copy that address into your browser and hopefully you should be greeted with a Mainsail user interface.

You will almost certainly have a Klippy error because you haven’t defined a board yet.

Plug in your controller board of choice and find the serial port using the following command. You should get the serial id you need to paste into your Klipper config.

ls /dev/serial/by-id/*

And thats it guys! you are ready to move onto setting up your printer controller board.

Follow instructions specific to your board to flash the firmware and then update your printer.cfg file as per any other Klipper install! Hope you liked it and that this helps some people out who are scared of using a non-official Raspberry Pi board!

Support 3DP and ME! Help us keep producing tutorials, content and mods!


14 thoughts on “Tutorial: Orange Pi Zero Plus Klipper Install

  1. Hello
    I used to use a 5V power with 5A for raspberry 4, could I use it for orang pi?
    Will it cause any restriction, If we use orange pi rather than raspberry?


  2. When i try to plug in the Orange Pi to boot, it is not recognized by my computer and only a red solid led lights up. 😦


  3. Thanks for provide instructions to install Klipper. I could install Klipper with Orange Pi Zero LTS with 256MB SDRAM. I have to create swap file to have enough memory to install it.

    Here are some commands that I did to have swap space.

    sudo dd if=/dev/zero of=/swapfile2 bs=1024 count=104857
    sudo mkswap /swapfile
    sudo chmod 600 /swapfile
    sudo swapon /swapfile

    Then use this command to open fstab file:

    sudo nano /etc/fstab

    And add bellow line at the end of fstab file:

    /swapfile none swap sw 0 0

    Then save file and exit.

    Bellow commands are to check if it works:

    swapon –show
    free -H

    Hope this could help any one want to install klipper into a system with small memory like Orange Pi Zero LTS (256MBs of SDRAM)


      1. Sorry, there is a typo ==> extra number in first line
        should be sudo dd if=/dev/zero of=/swapfile bs=1024 count=104857


      2. Fixing the type from previous post.
        Here are some commands that I did to have swap space.
        sudo dd if=/dev/zero of=/swapfile bs=1024 count=1024857
        sudo mkswap /swapfile
        sudo chmod 600 /swapfile
        sudo swapon /swapfile
        Then use this command to open fstab file:
        sudo nano /etc/fstab
        And add bellow line at the end of fstab file:
        /swapfile none swap sw 0 0
        Then save file and exit.
        Bellow commands are to check if it works:
        free -h


  4. When I installed klipper on Orange Pi Zero LTS which only has 256MB of memory, I noticed that installing moonraker will fail at the step of pip downloading Pillow and expanding it because the zram space mounted at /tmp folder is only 120MBs (haft of orangepi zero LTS board memory of 256MB). The reason is pip use /tmp folder as temp dir so run this command ” export TMPDIR=/var/tmp ” will change temp dir to /var/tmp which is in main partition. This will help installing klipper on Orange Pi Zero LTS successful.


Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

%d bloggers like this: