GuidesKlipper Firmware

How to Install KlipperWRT on Creality Box?

The Creality Box isn’t the most useful piece of hardware. But you can get more out of it by installing KlipperWRT and turning it into a Klipper controller. In this guide, I will show you how to install OpenWRT on the Creality Box, then convert it to Klipper.

What is KlipperWRT?

KlipperWRT is an OpenWRT linux distro which is mostly used with network devices like routers. Because most of the time these routers don’t have a lot of computing power, the distro needs to be as efficient as possible. This is the main reason OpenWRT is a good choice as a base for installing Klipper on the Creality Box.

Why Install KlipperWRT on the Creality Box?

The Creality Box specs are quite underwhelming, and Creality chose to use this box as a bridge between the internet and their 3D printers. You can connect the Creality Box to your printer and send STL files from Creality Cloud directly to your machine. Besides that, you can also connect a Webcam to the Creality Box and watch over your print.

If you decide to upgrade the Creality Box with KlipperWRT, you will be able to use the device as a Raspberry Pi replacement and run Klipper directly from it. Klipper will allow you to print faster with your 3D printer and you will also be able to control the printer using a Web Interface, directly from your computer.

Besides that, after you install Klipper on your 3D printer, you can use features like Pressure Advance and Input Shaper, which will greatly improve your print quality.

Steps to install KlipperWRT on the Creality Box

Connect the Creality Box to a network

The first step is to connect the Creality Box to a network via Wi-Fi or via a LAN cable. I used the Creality Cloud app to connect on my Wi-Fi access point. You just need to install Creality Cloud and follow the steps in the app to connect to your network.

After you connect to Wi-Fi, you need to find out what IP is used by your Creality Box. You can check this by connecting to your router, but I use the WIFIMan app which automatically scans my network and lists the IPs of my machines.

After you find your IP, you can move to the next step.

Flash KlipperWRT firmware

After you found the IP address of your Creality Box, open up a browser and open the Admin interface using the following address, after you change the IP to your own.

The default username is admin and the password is admin. After the login, you will land on this page:

CrealityBox Admin interface | How to Install KlipperWRT on Creality Box?

Download the OpenWRT firmware, extract the archive, then navigate to Administration -> Upload Firmware. Click on Choose File, select the .bin firmware you just downloaded and click on Apply. The firmware will be uploaded to the box.

CR 10 Smart Flash Stock Firmware | How to Install KlipperWRT on Creality Box?

After the firmware is uploaded, you will get a failure message: “Not a valid firmware. Bag Magic Number: “/var/tmpFW” is no valid image”. Ignore the message and continue to the next step.

Not a valid firmware message | How to Install KlipperWRT on Creality Box?

Open up the system command terminal. In my case, the address is In this terminal, we need to run the following command:

mv /var/tmpFW /media/mmcblk0p1/cxsw_update.tar.bz2

After you run this command, we need to reboot the Creality Box. Just type the following command, then enter.


The Creality Box will be rebooted, and after about 5 mintes, the printer will broadcast a new Wi-Fi network called KlipperWRT. On your computer, connect to the KlipperWRT Wi-Fi network and move to the next step.

Connect KlipperWRT to Wi-Fi

Navigate to Network ->Wireless then click on the Scan button to scan for Wi-Fi networks.

Scan for Wi FI networks in KlipperWRT | How to Install KlipperWRT on Creality Box?

Select the Wi-Fi network you want to connect to, and click Join Network

Select the Wi Fi network you want to connect to | How to Install KlipperWRT on Creality Box?
How to Install KlipperWRT on Creality Box? 1

In the next screen, ensure that you configure everything like in the image below, then click Submit. The Create/Assign Firewall Zone should be set on WWAN.

Wi Fi settings for KlipperWRT | How to Install KlipperWRT on Creality Box?

Finally, click on Save & Apply to save the newly created connection and connect to the Wi-Fi network.

Save and apply the KlipperWRT connection | How to Install KlipperWRT on Creality Box?
How to Install KlipperWRT on Creality Box? 2

Now you can disconnect from the KlipperWRT Wi-Fi network and connect back to your default Wi-Fi. The Wi-Fi box will connect to your Wi-Fi. If everything is right, the LuCi webpage can be opened with the new IP.

You can now go to Services-> Terminal -> Config and change the Interface to WWAN, then save your changes. This will allow you to use the integrated terminal, and install KlipperWRT.

Install Klipper

In your Terminal window, paste the script from GitHub and wait for the installation to complete.

cd ~
chmod +x

When prompted to reboot, type the reboot command and access the terminal again, to paste the installation script.

cd ~
chmod +x

The Kipper installation guide will start. The process takes about 20 minutes, and during that time, your will be prompted to select the type of web interface you want to use (Fluidd/Mainsail).

When finished, remove the scripts with the following command:

rm -rf /root/*.sh

That’s it. Now you can import the printer.cfg file of your 3D printer, and start using Klipper on the Creality Box

Video Guide for KlipperWRT

Since I wrote this guide, a video showing the installation process was posted on YouTube. Feel free to check it out if you get stuck.

Wrapping up

I hope this guide has been helpful for you in adding more use to your Creality Box. In a future article, I will show you how to install Klipper on the CR-10 Smart which already has a Creality Box inside the printer. Feel free to also join the 3DPrintBeginner Discord Server where there’s a dedicated channel for the Klipper WRT.

Liked it?
Take a second to support 3DPrintBeginner on Patreon!

Notify of
Inline Feedbacks
View all comments